{
  "openapi": "3.1.0",
  "info": {
    "title": "france-naturalisation.net — Données ouvertes",
    "description": "Jeux de données publics et en lecture seule (sans authentification) sur la naturalisation française : statistiques de décrets, répartition par nationalité, annuaires de centres d'examen. Licence Ouverte 2.0 (Etalab) — réutilisation libre, y compris commerciale, sous réserve de mention de la source.",
    "version": "1.0.0",
    "contact": {
      "email": "info@france-naturalisation.net"
    },
    "license": {
      "name": "Licence Ouverte 2.0 (Etalab)",
      "url": "https://www.etalab.gouv.fr/licence-ouverte-open-licence/"
    }
  },
  "servers": [
    {
      "url": "https://france-naturalisation.net"
    }
  ],
  "paths": {
    "/stats-naturalisation.json": {
      "get": {
        "operationId": "getNaturalisationStats",
        "summary": "Statistiques agrégées des décrets de naturalisation",
        "description": "Volume total de décrets recensés depuis 2016 et fréquence de publication mensuelle (min/max/moyenne) sur les 12 derniers mois, recalculés à chaque build à partir du jeu de données complet.",
        "responses": {
          "200": {
            "description": "Statistiques agrégées",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "source": {
                      "type": "string"
                    },
                    "license": {
                      "type": "string",
                      "format": "uri"
                    },
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "sourceDataset": {
                      "type": "string",
                      "format": "uri"
                    },
                    "decreesRecensed": {
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "integer"
                        },
                        "since": {
                          "type": "string"
                        }
                      }
                    },
                    "monthlyPublicationFrequency": {
                      "type": "object",
                      "properties": {
                        "periodMonths": {
                          "type": "integer"
                        },
                        "min": {
                          "type": "integer"
                        },
                        "max": {
                          "type": "integer"
                        },
                        "average": {
                          "type": "integer"
                        },
                        "unit": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/naturalisations-nationalite.json": {
      "get": {
        "operationId": "getNaturalisationsByNationality",
        "summary": "Naturalisations françaises par nationalité (2016-2026)",
        "description": "Nombre de personnes naturalisées par décret entre 2016 et 2026, par nationalité d'origine, avec répartition femmes/hommes et rang national.",
        "responses": {
          "200": {
            "description": "Liste des nationalités avec leurs statistiques",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "nationalite": {
                        "type": "string"
                      },
                      "naturalisations_2016_2026": {
                        "type": "integer"
                      },
                      "rang_national": {
                        "type": "integer"
                      },
                      "part_femmes_pct": {
                        "type": "integer"
                      },
                      "part_hommes_pct": {
                        "type": "integer"
                      },
                      "fiche_pays_url": {
                        "type": "string",
                        "format": "uri"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/naturalisations-nationalite.csv": {
      "get": {
        "operationId": "getNaturalisationsByNationalityCsv",
        "summary": "Naturalisations françaises par nationalité (2016-2026), format CSV",
        "responses": {
          "200": {
            "description": "Fichier CSV",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/centres-examen-civique.json": {
      "get": {
        "operationId": "getCentresExamenCivique",
        "summary": "Annuaire des centres d'examen civique et TCF pour la naturalisation",
        "responses": {
          "200": {
            "description": "Liste des centres",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "address": {
                        "type": "string"
                      },
                      "cityLine": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string",
                        "format": "uri"
                      },
                      "lat": {
                        "type": "number"
                      },
                      "lon": {
                        "type": "number"
                      },
                      "slug": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/centres-examen-civique.csv": {
      "get": {
        "operationId": "getCentresExamenCiviqueCsv",
        "summary": "Annuaire des centres d'examen civique et TCF, format CSV",
        "responses": {
          "200": {
            "description": "Fichier CSV",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/centres-delf-dalf.json": {
      "get": {
        "operationId": "getCentresDelfDalf",
        "summary": "Annuaire des centres d'examen DELF/DALF",
        "responses": {
          "200": {
            "description": "Liste des centres",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "address": {
                        "type": "string"
                      },
                      "cityLine": {
                        "type": "string"
                      },
                      "phone": {
                        "type": "string",
                        "nullable": true
                      },
                      "email": {
                        "type": "string",
                        "nullable": true
                      },
                      "url": {
                        "type": "string",
                        "format": "uri",
                        "nullable": true
                      },
                      "lat": {
                        "type": "number"
                      },
                      "lon": {
                        "type": "number"
                      },
                      "slug": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/centres-delf-dalf.csv": {
      "get": {
        "operationId": "getCentresDelfDalfCsv",
        "summary": "Annuaire des centres d'examen DELF/DALF, format CSV",
        "responses": {
          "200": {
            "description": "Fichier CSV",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}