{
  "openapi": "3.0.3",
  "info": {
    "title": "API publique des certificats ANRDI",
    "version": "1.0.0",
    "description": "API publique pour lister et rechercher les certificats ANRDI."
  },
  "servers": [
    {
      "url": "https://certification.anrdi.fr"
    }
  ],
  "paths": {
    "/api": {
      "get": {
        "summary": "Informations generales de l'API",
        "responses": {
          "200": {
            "description": "Metadonnees de l'API"
          }
        }
      }
    },
    "/api/certificats": {
      "get": {
        "summary": "Lister les certificats publics ou rechercher un certificat par numero",
        "parameters": [
          {
            "name": "numero",
            "in": "query",
            "required": false,
            "description": "Numero exact du certificat a rechercher.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Numero de page pour la liste.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "description": "Taille de page pour la liste.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Reponse JSON de liste ou de recherche"
          },
          "404": {
            "description": "Certificat introuvable"
          },
          "503": {
            "description": "Service temporairement indisponible"
          }
        }
      }
    }
  }
}