# 📚 INDEX DE L'ANALYSE API INFOPARCELLE

**Date d'analyse:** 2025-11-17
**Fichier source:** `/home/user/Infoparcelle-MCP/docs-openapi.json` (1.2MB)

---

## 📄 FICHIERS GÉNÉRÉS

### 🎯 Documents principaux (dans le repository)

#### 1. **ANALYSE_API_COMPLETE.md** (17K)
**Chemin:** `/home/user/Infoparcelle-MCP/ANALYSE_API_COMPLETE.md`
**Description:** Document exhaustif avec tous les endpoints, paramètres et champs de réponse
**Contenu:**
- Statistiques globales (20 endpoints, 410 paramètres)
- Liste complète des endpoints par catégorie
- Détails de chaque endpoint avec tous les paramètres
- Champs disponibles dans les réponses
- Informations d'authentification et limites
- Cas d'usage et exemples

**👉 À utiliser pour:** Documentation complète de référence

---

#### 2. **QUICK_REFERENCE.md** (6.4K)
**Chemin:** `/home/user/Infoparcelle-MCP/QUICK_REFERENCE.md`
**Description:** Guide de référence rapide et pratique
**Contenu:**
- Vue d'ensemble en un coup d'œil
- Tableau récapitulatif des endpoints
- Paramètres transversaux (pagination, formats, géométries)
- Exemples d'utilisation rapides
- Filtres principaux par endpoint
- Tips et bonnes pratiques

**👉 À utiliser pour:** Développement quotidien, aide-mémoire

---

### 📊 Fichiers techniques (dans /tmp)

#### 3. **analyse_complete_api.txt** (84K)
**Chemin:** `/tmp/analyse_complete_api.txt`
**Description:** Analyse textuelle complète avec formatage console
**Contenu:**
- Analyse détaillée de chaque endpoint
- Liste exhaustive des paramètres avec descriptions
- Réponses possibles avec codes HTTP
- Format: texte formaté pour terminal

**👉 À utiliser pour:** Lecture en terminal, scripts

---

#### 4. **api_structure.json** (280K)
**Chemin:** `/tmp/api_structure.json`
**Description:** Structure JSON complète de l'API
**Contenu:**
- Métadonnées (info, servers, tags)
- Tous les endpoints avec détails
- Paramètres structurés (requis/optionnels)
- Réponses avec types de contenu
- Format: JSON parsable

**👉 À utiliser pour:** Traitement automatisé, génération de code

---

#### 5. **response_fields.txt** (13K)
**Chemin:** `/tmp/response_fields.txt`
**Description:** Liste des champs disponibles dans les réponses
**Contenu:**
- Pour chaque endpoint ayant un paramètre "champs"
- Liste complète des champs disponibles
- Indication des champs par défaut (✓)
- Champs optionnels ( )

**👉 À utiliser pour:** Comprendre les données retournées

---

## 📊 STATISTIQUES DE L'ANALYSE

```
Total d'endpoints analysés:     20
Total de paramètres:           410
Catégories:                      4
  - Géocodage:                   3 endpoints
  - Parcelles:                   4 endpoints
  - Données territoriales:       6 endpoints
  - Foncier & Immobilier:        7 endpoints

Lignes de documentation:     ~2000
Taille totale des fichiers:   ~500K
Temps d'analyse:              ~5 minutes
```

---

## 🎯 UTILISATION RECOMMANDÉE

### Pour démarrer rapidement
1. Lire **QUICK_REFERENCE.md** pour avoir une vue d'ensemble
2. Tester les exemples fournis
3. Se référer à **ANALYSE_API_COMPLETE.md** pour les détails

### Pour l'intégration
1. Utiliser **api_structure.json** pour générer du code
2. Consulter **response_fields.txt** pour les champs disponibles
3. Suivre les bonnes pratiques dans **QUICK_REFERENCE.md**

### Pour la documentation d'équipe
1. Partager **ANALYSE_API_COMPLETE.md** comme référence
2. Utiliser **QUICK_REFERENCE.md** comme aide-mémoire
3. Ajouter vos propres notes et cas d'usage

---

## 📋 RÉSUMÉ PAR CATÉGORIE

### 🌍 GÉOCODAGE
- ✅ 3 endpoints
- 🔑 Convertir adresses ↔ coordonnées
- 📍 Géocodage inverse
- 🏠 Lier adresses aux parcelles

### 🏘️ PARCELLES
- ✅ 4 endpoints
- 🔍 79 filtres de recherche
- 📄 Fiche parcelle complète (27 champs)
- 🖼️ Prévisualisation SVG

### 🗺️ TERRITOIRES
- ✅ 6 endpoints
- 🌍 Régions, départements, communes
- 📐 Sections cadastrales, quartiers (IRIS)
- 🏛️ EPCI (intercommunalités)

### 🏢 FONCIER & IMMOBILIER
- ✅ 7 endpoints
- ⚡ DPE (diagnostics énergétiques)
- 💰 DVF (transactions immobilières)
- 📜 PLU (urbanisme)
- 🏗️ Permis de construire
- 👥 Propriétaires, copropriétés, occupants

---

## 🔗 LIENS UTILES

- **API Base URL:** https://app.infoparcelle.fr
- **Documentation:** https://infoparcelle.fr
- **Compte API:** https://www.infoparcelle.fr/compte/api
- **Support:** contact@infoparcelle.fr

---

## ⚡ POINTS CLÉS À RETENIR

1. **Authentification:** Bearer Token obligatoire
2. **Limite:** 1200 req/min (20 req/s)
3. **Pagination:** Par curseur (cursor-based)
4. **Formats:** JSON et GeoJSON
5. **Géométries:** centre, contour, bbox
6. **Filtres:** Recherche parcelles nécessite 1 filtre géo minimum
7. **Personnalisation:** Paramètre `champs` pour sélectionner les données

---

**Index généré automatiquement - 2025-11-17**