API publique

Principes

• Sans authentification — données publiques, accessibles à tout tiers
• JSON paginé — format { pagination, links, data } avec liens HATEOAS
• CORS — Access-Control-Allow-Origin: * pour un usage cross-origin libre
• Cache CDN — réponses cachées 5 min côté client, 30 min côté CDN
• Pagination par offset — paramètres standards limit et offset
• OpenAPI 3.1 — spécification machine-readable disponible sur /api/v1/openapi

Points d'accès

• GET/api/v1/immortels

  Liste paginée des académiciens

  Paramètres

  Nom	Type	Description
  q	string	Recherche libre (≥ 2 caractères)
  status	active|deceased	Filtrer par statut
  limit	int	Taille de page (défaut 50, max 200)
  offset	int	Position de départ

  Exemple

  GET /api/v1/immortels?status=active&limit=5
• GET/api/v1/discours

  Liste paginée des discours

  Paramètres

  Nom	Type	Description
  q	string	Recherche libre
  type	reception|communication|hommage|annual	Filtrer par type
  limit	int	Taille de page
  offset	int	Position de départ

  Exemple

  GET /api/v1/discours?type=reception&limit=10
• GET/api/v1/prix

  Liste paginée des prix littéraires

  Paramètres

  Nom	Type	Description
  q	string	Recherche libre
  category	enum	Catégorie (grand-prix, fondations, …)
  limit	int	Taille de page
  offset	int	Position de départ

  Exemple

  GET /api/v1/prix?category=grand-prix

Exemple de réponse

{
  "resource": "immortels",
  "pagination": { "total": 239, "limit": 50, "offset": 0, "returned": 50 },
  "links": {
    "self":  "https://.../api/v1/immortels?limit=50",
    "first": "https://.../api/v1/immortels?offset=0&limit=50",
    "next":  "https://.../api/v1/immortels?offset=50&limit=50",
    "prev":  null
  },
  "data": [
    {
      "fauteuil": 1,
      "slug": "claude-dagens",
      "prenom": "Claude",
      "nom": "DAGENS",
      "profession": "Homme d'Église",
      "electionYear": 2008,
      "status": "active",
      "href": "https://www.academie-francaise.fr/immortels/claude-dagens"
    }
  ]
}