{
  "service": "rankopress-data-api",
  "version": "1.0.0",
  "description": "Aggregator + cache KV des APIs gratuites tierces pour les sites RANKOPRESS.",
  "endpoints": [
    {
      "path": "/weather/:lat/:lon",
      "ttl": "1h",
      "source": "Open-Meteo"
    },
    {
      "path": "/air-quality/:lat/:lon",
      "ttl": "1h",
      "source": "Open-Meteo AQ"
    },
    {
      "path": "/agenda/:city",
      "ttl": "1h",
      "source": "OpenAgenda"
    },
    {
      "path": "/postal-code/:code",
      "ttl": "30d",
      "source": "api-adresse.data.gouv.fr"
    },
    {
      "path": "/holidays/:country/:year",
      "ttl": "30d",
      "source": "Nager.Date"
    },
    {
      "path": "/exchange[?base=EUR]",
      "ttl": "6h",
      "source": "exchangerate-api.com"
    },
    {
      "path": "/sunrise/:lat/:lon[?date=]",
      "ttl": "24h",
      "source": "sunrise-sunset.org"
    },
    {
      "path": "/traffic/:region",
      "ttl": "15m",
      "source": "Bison Futé (placeholder)"
    },
    {
      "path": "/company/:siren",
      "ttl": "30d",
      "source": "recherche-entreprises.api.gouv.fr"
    },
    {
      "path": "/prayer/:lat/:lon[?method=2]",
      "ttl": "24h",
      "source": "Aladhan (islamique)"
    },
    {
      "path": "/earthquakes[?period=day&min_mag=2.5]",
      "ttl": "30m",
      "source": "USGS"
    },
    {
      "path": "/iss",
      "ttl": "30s",
      "source": "Open Notify (position ISS)"
    },
    {
      "path": "/hackernews[?limit=15]",
      "ttl": "15m",
      "source": "HN Firebase"
    },
    {
      "path": "/wikipedia/:lang/:title",
      "ttl": "7d",
      "source": "Wikipedia REST"
    },
    {
      "path": "/aircrafts/:lat/:lon[?radius=1]",
      "ttl": "1m",
      "source": "OpenSky Network"
    },
    {
      "path": "/random-users[?count=5&nat=fr]",
      "ttl": "0 (fresh)",
      "source": "randomuser.me"
    },
    {
      "path": "/qr?text=...&size=300",
      "ttl": "24h",
      "source": "goqr.me (URL builder)"
    }
  ],
  "docs": "https://github.com/rankogroup/rankopress-saas/apps/data-api"
}