Endpoints API - Compatibilité Symfony

✅ Status: TOUT FONCTIONNEL

Tous les endpoints requis par l'application Symfony sont 100% opérationnels.

📋 Endpoints Testés

1. Détails d'un département avec région

bash

curl "https://2mnservices.alwaysdata.net/departements/83?fields=code,nom,codeRegion,region"

Réponse :

json

{
  "code": "83",
  "nom": "Var",
  "codeRegion": "93",
  "region": {
    "code": "93",
    "nom": "Provence-Alpes-Côte d'Azur"
  }
}

2. Communes d'un département

bash

curl "https://2mnservices.alwaysdata.net/departements/83/communes?limit=3"

Réponse :

json

[
  {
    "nom": "Aiguines",
    "code": "83002",
    "codeDepartement": "83",
    "codeRegion": "93",
    "codesPostaux": ["83630"],
    "population": 270
  }
]

3. Détails d'une commune

bash

curl "https://2mnservices.alwaysdata.net/communes/75056?fields=nom,codeDepartement,codeRegion,codesPostaux,centre,population,surface"

Réponse :

json

{
  "nom": "Paris",
  "codeDepartement": "75",
  "codeRegion": "11",
  "codesPostaux": ["75001", "75002", ...],
  "centre": {
    "type": "Point",
    "coordinates": [2.347, 48.8589]
  },
  "population": 2103778,
  "surface": 105.36
}

4. Recherche de communes par nom

bash

curl "https://2mnservices.alwaysdata.net/communes?nom=Paris&fields=code,nom,codeDepartement,codeRegion,codesPostaux,centre,population,surface&boost=population&limit=1"

Réponse :

json

[
  {
    "nom": "Paris",
    "code": "75056",
    "codeDepartement": "75",
    "codeRegion": "11",
    "codesPostaux": ["75001", "75002", ...],
    "centre": {"type": "Point", "coordinates": [2.347, 48.8589]},
    "population": 2103778,
    "surface": 105.36
  }
]

5. Détails d'une région

bash

curl "https://2mnservices.alwaysdata.net/regions/11?fields=code,nom"

Réponse :

json

{
  "code": "11",
  "nom": "Île-de-France"
}

🔧 Commandes d'installation

bash

# Importer les régions (obligatoire pour avoir les noms de régions)
npm run import:regions

# Importer les départements
npm run import:departements

# Importer les communes
npm run import:communes

# Enrichir les communes (coordonnées, codes postaux, population, surface)
npm run enrich:communes

# Démarrer l'API
npm start

✅ Checklist finale

Endpoint	Champs requis	Status
`GET /departements/{code}`	`code,nom,codeRegion,region`	✅ OK
`GET /departements/{code}/communes`	`code,nom,codesPostaux`	✅ OK
`GET /communes/{code}`	`nom,codeDepartement,codeRegion,codesPostaux,centre,population,surface`	✅ OK
`GET /communes?nom=`	`code,nom,codeDepartement,codeRegion,codesPostaux,centre,population,surface`	✅ OK
`GET /regions/{code}`	`code,nom`	✅ OK

L'API est prête pour Symfony ! 🎉