permisapi-client 0.8.1__tar.gz → 0.9.1__tar.gz

{permisapi_client-0.8.1 → permisapi_client-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: permisapi-client
-Version: 0.8.1
+Version: 0.9.1
 Summary: Client Python officiel pour PermisAPI : permis de construire de France en API REST.
 Project-URL: Homepage, https://permisapi.fr
 Project-URL: Documentation, https://permisapi.fr/docs
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 
 # permisapi-client
 
-Client Python officiel de [PermisAPI](https://permisapi.fr) : 1,3 million de permis de
+Client Python officiel de [PermisAPI](https://permisapi.fr) : plus de 3 millions de permis de
 construire en France (base Sitadel, permis autorisés depuis 2013, 101 départements) dans
 une API REST.
 
@@ -57,6 +57,13 @@ nearby = client.permits.near(lat=48.8599, lng=2.3423, radius_m=300)
 # Détail d'un permis
 permit = client.permits.get("07510125V0025")
 
+# Un même numéro peut porter plusieurs autorisations (un PC et un PD, par
+# exemple) : la fiche liste les autres types dans autres_types, et type=
+# en désigne une. permit["identifiant"] (type et numéro accolés) est la
+# forme à conserver ; elle est acceptée partout à la place du numéro.
+if permit.get("autres_types"):
+    autre = client.permits.get(permit["num_pa"], type=permit["autres_types"][0])
+
 # Statistiques d'une commune (Paris entier est rangé sous le code 75056 dans Sitadel)
 stats = client.stats.commune("75056")
 print(stats["total_permits"], stats["granted"], stats["trend_yoy_pct"])
@@ -68,16 +75,17 @@ for p in client.permits.iter_all(dep_code="75", permit_type="PC_LOGEMENT"):
 
 Coût : une recherche (`list`, `iter_all`, `near`, `search`) décompte 1 requête par permis
 renvoyé. `iter_all` sur un département entier peut donc épuiser le quota mensuel de la
-formule Gratuit (500 requêtes) ou Explorer (5 000).
+formule Gratuit (500 requêtes), Découverte (2 000) ou Explorateur (5 000).
 
-Formules : **Gratuit** (1 département, 6 mois d'historique), **Explorer** (5 départements,
-6 mois), **Régional** (5 départements, historique complet et données avancées), **Pro**
-(les mêmes données avancées sur la France entière), **Business** et **Enterprise**. Les
+Formules : **Gratuit** (1 département, les nouveaux permis des 2 dernières publications
+Sitadel), **Découverte** (1 département, 6 mois), **Explorateur** (5 départements, 12 mois),
+**Régional** (5 départements, historique complet et données avancées), **Pro** (les mêmes
+données avancées sur la France entière), **Business** et **Entreprise**. Les
 exemples de cette page portent sur Paris (75).
 
-## Données avancées (formules Régional, Pro, Business et Enterprise)
+## Données avancées (formules Régional, Pro, Business et Entreprise)
 
-Les formules Gratuit et Explorer reçoivent une erreur 402 sur ces routes.
+Les formules Gratuit, Découverte et Explorateur reçoivent une erreur 402 sur ces routes.
 
 ```python
 num_pa = "07510125V0025"
@@ -91,8 +99,8 @@ print("Prix médian au m² :", dvf["dvf_median_price_per_m2"])
 # Score d'opportunité marchand de biens v0.3 (note 0-100 et palier)
 score = client.permits.score_mdb(num_pa)
 print(f"Score : {score['score']}/100 ({score['tier']})")
-# Score déjà pré-calculé : components vaut None ; le détail des 11 signaux
-# est donné par la route /v1/permits/{num_pa}/score/explain.
+# score["components"] : note 0-100 de chacun des 11 signaux ; une explication
+# en français de chaque signal : route /v1/permits/{num_pa}/score/explain.
 
 # Zonage PLU (constructible, à urbaniser, agricole, naturel)
 plu = client.permits.plu(num_pa)
@@ -102,9 +110,9 @@ if plu["has_plu"]:
 
 # Risques Géorisques (inondation, séisme, sites Seveso proches...)
 risks = client.permits.risks(num_pa)
-print(f"Risque : {risks['risk_score']}/100 ({risks['risk_tier']})")
-for risk in risks["risks"]:
-    print(f"- {risk['label']} (PPR : {risk['has_ppr']})")
+print(risks["risk_summary"])  # niveau, et ce qu'il mesure
+for raison in risks["risk_reasons"]:  # d'où viennent les points
+    print("-", raison)
 
 # Votre avis sur un score
 client.permits.score_feedback(
@@ -117,10 +125,10 @@ client.permits.score_feedback(
 )
 ```
 
-## Export CSV (Business et Enterprise)
+## Export CSV (Business et Entreprise)
 
 ```python
-# Plafond : 100 000 lignes en Business, 1 000 000 en Enterprise
+# Plafond : 100 000 lignes en Business, 1 000 000 en Entreprise
 csv_bytes = client.permits.export(
     dep_code="75",
     permit_type="PC_LOGEMENT",
@@ -133,7 +141,7 @@ with open("paris.csv", "wb") as f:
 
 ## Serveur MCP (Claude, ChatGPT, Cursor)
 
-Le serveur MCP officiel (paquet séparé `permisapi-mcp`) permet à Claude, ChatGPT, Claude
+Le connecteur PermisAPI (paquet séparé `permisapi-mcp`) permet à Claude, ChatGPT, Claude
 Desktop, Cursor et Windsurf d'interroger PermisAPI en langage naturel :
 
 ```bash
@@ -196,6 +204,12 @@ except PermisAPIRateLimited as e:
     print(f"Trop de requêtes par minute, nouvel essai possible dans {e.retry_after} s")
 ```
 
+## Journal des versions
+
+- **0.9.1** (13/11/2026, filtres de zonage) : la documentation de `permits.list` dit la portée des filtres `plu_zone_type` et `plu_constructible` (le zonage est calculé pour les permis géolocalisés autorisés depuis 48 mois ; les plus anciens sont ajoutés progressivement ; un permis sans zonage enregistré est exclu). Aucun changement de comportement.
+- **0.9.0** (12/11/2026, bascule de la clé type et numéro, C24) : argument facultatif `type` (`PC`, `DP`, `PA` ou `PD`) sur les méthodes qui prennent un `num_pa` ; `identifiant` (`PC0330632600176`) accepté partout à la place du numéro ; l'export CSV gagne `type_autorisation` et `identifiant` en fin de ligne. Version mineure : ajouts seulement, aucun appel existant ne change.
+- Versions précédentes : historique du dépôt (`git log -- sdk-python/`).
+
 ## Licence
 
 MIT. Source des permis : SDES, base Sitadel, data.gouv.fr (Licence Ouverte Etalab).

{permisapi_client-0.8.1 → permisapi_client-0.9.1}/README.md

@@ -1,6 +1,6 @@
 # permisapi-client
 
-Client Python officiel de [PermisAPI](https://permisapi.fr) : 1,3 million de permis de
+Client Python officiel de [PermisAPI](https://permisapi.fr) : plus de 3 millions de permis de
 construire en France (base Sitadel, permis autorisés depuis 2013, 101 départements) dans
 une API REST.
 
@@ -29,6 +29,13 @@ nearby = client.permits.near(lat=48.8599, lng=2.3423, radius_m=300)
 # Détail d'un permis
 permit = client.permits.get("07510125V0025")
 
+# Un même numéro peut porter plusieurs autorisations (un PC et un PD, par
+# exemple) : la fiche liste les autres types dans autres_types, et type=
+# en désigne une. permit["identifiant"] (type et numéro accolés) est la
+# forme à conserver ; elle est acceptée partout à la place du numéro.
+if permit.get("autres_types"):
+    autre = client.permits.get(permit["num_pa"], type=permit["autres_types"][0])
+
 # Statistiques d'une commune (Paris entier est rangé sous le code 75056 dans Sitadel)
 stats = client.stats.commune("75056")
 print(stats["total_permits"], stats["granted"], stats["trend_yoy_pct"])
@@ -40,16 +47,17 @@ for p in client.permits.iter_all(dep_code="75", permit_type="PC_LOGEMENT"):
 
 Coût : une recherche (`list`, `iter_all`, `near`, `search`) décompte 1 requête par permis
 renvoyé. `iter_all` sur un département entier peut donc épuiser le quota mensuel de la
-formule Gratuit (500 requêtes) ou Explorer (5 000).
+formule Gratuit (500 requêtes), Découverte (2 000) ou Explorateur (5 000).
 
-Formules : **Gratuit** (1 département, 6 mois d'historique), **Explorer** (5 départements,
-6 mois), **Régional** (5 départements, historique complet et données avancées), **Pro**
-(les mêmes données avancées sur la France entière), **Business** et **Enterprise**. Les
+Formules : **Gratuit** (1 département, les nouveaux permis des 2 dernières publications
+Sitadel), **Découverte** (1 département, 6 mois), **Explorateur** (5 départements, 12 mois),
+**Régional** (5 départements, historique complet et données avancées), **Pro** (les mêmes
+données avancées sur la France entière), **Business** et **Entreprise**. Les
 exemples de cette page portent sur Paris (75).
 
-## Données avancées (formules Régional, Pro, Business et Enterprise)
+## Données avancées (formules Régional, Pro, Business et Entreprise)
 
-Les formules Gratuit et Explorer reçoivent une erreur 402 sur ces routes.
+Les formules Gratuit, Découverte et Explorateur reçoivent une erreur 402 sur ces routes.
 
 ```python
 num_pa = "07510125V0025"
@@ -63,8 +71,8 @@ print("Prix médian au m² :", dvf["dvf_median_price_per_m2"])
 # Score d'opportunité marchand de biens v0.3 (note 0-100 et palier)
 score = client.permits.score_mdb(num_pa)
 print(f"Score : {score['score']}/100 ({score['tier']})")
-# Score déjà pré-calculé : components vaut None ; le détail des 11 signaux
-# est donné par la route /v1/permits/{num_pa}/score/explain.
+# score["components"] : note 0-100 de chacun des 11 signaux ; une explication
+# en français de chaque signal : route /v1/permits/{num_pa}/score/explain.
 
 # Zonage PLU (constructible, à urbaniser, agricole, naturel)
 plu = client.permits.plu(num_pa)
@@ -74,9 +82,9 @@ if plu["has_plu"]:
 
 # Risques Géorisques (inondation, séisme, sites Seveso proches...)
 risks = client.permits.risks(num_pa)
-print(f"Risque : {risks['risk_score']}/100 ({risks['risk_tier']})")
-for risk in risks["risks"]:
-    print(f"- {risk['label']} (PPR : {risk['has_ppr']})")
+print(risks["risk_summary"])  # niveau, et ce qu'il mesure
+for raison in risks["risk_reasons"]:  # d'où viennent les points
+    print("-", raison)
 
 # Votre avis sur un score
 client.permits.score_feedback(
@@ -89,10 +97,10 @@ client.permits.score_feedback(
 )
 ```
 
-## Export CSV (Business et Enterprise)
+## Export CSV (Business et Entreprise)
 
 ```python
-# Plafond : 100 000 lignes en Business, 1 000 000 en Enterprise
+# Plafond : 100 000 lignes en Business, 1 000 000 en Entreprise
 csv_bytes = client.permits.export(
     dep_code="75",
     permit_type="PC_LOGEMENT",
@@ -105,7 +113,7 @@ with open("paris.csv", "wb") as f:
 
 ## Serveur MCP (Claude, ChatGPT, Cursor)
 
-Le serveur MCP officiel (paquet séparé `permisapi-mcp`) permet à Claude, ChatGPT, Claude
+Le connecteur PermisAPI (paquet séparé `permisapi-mcp`) permet à Claude, ChatGPT, Claude
 Desktop, Cursor et Windsurf d'interroger PermisAPI en langage naturel :
 
 ```bash
@@ -168,6 +176,12 @@ except PermisAPIRateLimited as e:
     print(f"Trop de requêtes par minute, nouvel essai possible dans {e.retry_after} s")
 ```
 
+## Journal des versions
+
+- **0.9.1** (13/11/2026, filtres de zonage) : la documentation de `permits.list` dit la portée des filtres `plu_zone_type` et `plu_constructible` (le zonage est calculé pour les permis géolocalisés autorisés depuis 48 mois ; les plus anciens sont ajoutés progressivement ; un permis sans zonage enregistré est exclu). Aucun changement de comportement.
+- **0.9.0** (12/11/2026, bascule de la clé type et numéro, C24) : argument facultatif `type` (`PC`, `DP`, `PA` ou `PD`) sur les méthodes qui prennent un `num_pa` ; `identifiant` (`PC0330632600176`) accepté partout à la place du numéro ; l'export CSV gagne `type_autorisation` et `identifiant` en fin de ligne. Version mineure : ajouts seulement, aucun appel existant ne change.
+- Versions précédentes : historique du dépôt (`git log -- sdk-python/`).
+
 ## Licence
 
 MIT. Source des permis : SDES, base Sitadel, data.gouv.fr (Licence Ouverte Etalab).

{permisapi_client-0.8.1 → permisapi_client-0.9.1}/permisapi_client/__init__.py

@@ -31,4 +31,4 @@ __all__ = [
     "PermisAPIValidationError",
 ]
 
-__version__ = "0.8.1"
+__version__ = "0.9.1"

{permisapi_client-0.8.1 → permisapi_client-0.9.1}/permisapi_client/client.py

@@ -13,7 +13,25 @@ from permisapi_client.exceptions import error_from_response
 
 DEFAULT_BASE_URL = "https://api.permisapi.fr"
 DEFAULT_TIMEOUT = 15.0
-USER_AGENT = "permisapi-client-python/0.8.1"
+USER_AGENT = "permisapi-client-python/0.9.0"
+
+
+TYPES_AUTORISATION = ("PC", "DP", "PA", "PD")
+
+
+def _params_type(type_: str | None) -> dict[str, str] | None:
+    """Paramètre facultatif `type` des méthodes à `num_pa` (API, 05/11/2026) :
+    un même numéro peut porter plusieurs autorisations (un PC et un PD, par
+    exemple) ; `type="PD"` désigne laquelle. Sans lui, l'autorisation servie
+    par défaut (toujours la même pour un numéro), comme avant. Un type que ce
+    numéro ne porte pas donne une erreur 404. Même effet : passer
+    l'`identifiant` (`PD0330632600176`) à la place du numéro."""
+    if type_ is None or type_ == "":
+        return None
+    t = str(type_).strip().upper()
+    if t not in TYPES_AUTORISATION:
+        raise ValueError("type vaut PC, DP, PA ou PD")
+    return {"type": t}
 
 
 def _raise_for_status(resp: httpx.Response) -> None:
@@ -117,7 +135,7 @@ class _PermitsResource:
         6 travaux terminés (1 et 3 n'existent pas dans Sitadel).
 
         Filtre `min_score` (formules Régional, Pro, Business et
-        Enterprise ; 402 pour Gratuit et Explorer) : retourne uniquement
+        Entreprise ; 402 pour Gratuit, Découverte et Explorateur) : retourne uniquement
         les permis dont le Score Opportunité MDB est >= N (0-100). Cas
         d'usage marchand de biens : présélectionner les meilleures
         opportunités en un appel au lieu de filtrer côté client.
@@ -133,7 +151,18 @@ class _PermitsResource:
 
         Filtre `plu_constructible` (Régional et plus, 402 sinon) :
         booléen. `plu_constructible=True` ne retourne que les permis dont
-        le verdict heuristique est constructible (zone U ou AU).
+        le verdict heuristique est constructible (zone U ou AU),
+        `plu_constructible=False` les permis en zone A ou N.
+
+        Portée des deux filtres de zonage (texte recopié de
+        src/services/portee_zonage.py du dépôt de l'API).
+        Le zonage est calculé pour les permis géolocalisés autorisés depuis
+        48 mois ; les plus anciens sont ajoutés progressivement. Un permis
+        sans zonage enregistré (non géolocalisé, plus ancien et pas encore
+        calculé, ou situé là où aucun plan d'urbanisme n'est publié sur le
+        Géoportail de l'Urbanisme) est exclu, quelle que soit la valeur
+        demandée. Le zonage de n'importe quel permis géolocalisé reste
+        disponible par `permits.plu(num_pa)`.
         """
         return self._c._get("/v1/permits", params=params)
 
@@ -146,13 +175,13 @@ class _PermitsResource:
 
         Attention au quota : chaque permis retourné coûte 1 unité.
         Itérer sur un département entier peut consommer tout le quota
-        mensuel d'une formule Gratuit (500) ou Explorer (5 000).
+        mensuel d'une formule Gratuit (500), Découverte (2 000) ou Explorateur (5 000).
         """
         yield from _iter_pages(self.list, params)
 
-    def get(self, num_pa: str) -> dict[str, Any]:
+    def get(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}."""
-        return self._c._get(f"/v1/permits/{num_pa}")
+        return self._c._get(f"/v1/permits/{num_pa}", params=_params_type(type))
 
     def near(
         self, *, lat: float, lng: float, radius_m: int, **filters: Any
@@ -171,17 +200,17 @@ class _PermitsResource:
     def by_cadastre(self, *, section: str, numero: str) -> list[dict[str, Any]]:
         """GET /v1/permits/by-cadastre : liste nue des permis qui citent
         cette parcelle (section + numéro). Formules Régional et plus
-        (403 pour Gratuit et Explorer)."""
+        (403 pour Gratuit, Découverte et Explorateur)."""
         return self._c._get(
             "/v1/permits/by-cadastre",
             params={"section": section, "numero": numero},
         )
 
-    def parcelle(self, num_pa: str) -> dict[str, Any]:
+    def parcelle(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/parcelle : geometrie cadastre DGFiP.
 
-        Formules Régional, Pro, Business et Enterprise (402 pour Gratuit
-        et Explorer).
+        Formules Régional, Pro, Business et Entreprise (402 pour Gratuit,
+        Découverte et Explorateur).
         Retourne {num_pa, comm_code, section, numero, cadastre_id,
         surface_m2 (contenance officielle DGFiP), geometry (GeoJSON
         Polygon WGS84), cached_at, source}.
@@ -194,13 +223,13 @@ class _PermitsResource:
         un point lat/lng), comparer surface DGFiP vs Sitadel, cross-ref
         avec DVF en parcelle precise.
         """
-        return self._c._get(f"/v1/permits/{num_pa}/parcelle")
+        return self._c._get(f"/v1/permits/{num_pa}/parcelle", params=_params_type(type))
 
-    def batiments_existants(self, num_pa: str) -> dict[str, Any]:
+    def batiments_existants(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/batiments-existants : batiments
         cadastraux deja construits sur la parcelle du permit.
 
-        Formules Régional et plus (402 pour Gratuit et Explorer).
+        Formules Régional et plus (402 pour Gratuit, Découverte et Explorateur).
         Retourne :
           - num_pa, parcelle_cadastre_id, parcelle_surface_m2
           - nb_batiments (total), nb_bati_dur (type 01), nb_bati_leger
@@ -224,7 +253,7 @@ class _PermitsResource:
         (matching spatial impossible). Source : cadastre.data.gouv.fr
         (DGFiP via Etalab).
         """
-        return self._c._get(f"/v1/permits/{num_pa}/batiments-existants")
+        return self._c._get(f"/v1/permits/{num_pa}/batiments-existants", params=_params_type(type))
 
     def bulk_enrich(
         self,
@@ -247,8 +276,8 @@ class _PermitsResource:
 
         `ref` est echo dans la response pour mapper sur votre data.
 
-        Formules Business et Enterprise uniquement (402 pour Gratuit,
-        Explorer, Régional et Pro).
+        Formules Business et Entreprise uniquement (402 pour Gratuit,
+        Découverte, Explorateur, Régional et Pro).
 
         Args:
             rows: liste max 1000 lignes
@@ -272,6 +301,7 @@ class _PermitsResource:
         self,
         num_pa: str,
         *,
+        type: str | None = None,
         limit: int | None = None,
         type_local: str | None = None,
         include_terrains: bool | None = None,
@@ -281,10 +311,15 @@ class _PermitsResource:
     ) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/dvf : top-K transactions DVF voisines.
 
-        Formules Régional et plus (402 pour Gratuit et Explorer).
+        Formules Régional et plus (402 pour Gratuit, Découverte et Explorateur).
         Retourne {num_pa, permit_id, matches: [...],
-        dvf_median_price_per_m2, dvf_median_sample_size, filters_applied,
-        source, coverage}. Ventes DVF de 2021 à 2025.
+        dvf_median_price_per_m2, dvf_median_sample_size, dvf_median_basis,
+        filters_applied, source, coverage}. Ventes DVF de 2021 à 2025.
+
+        Le prix médian au m² est le même que dans `/360` et `score_mdb()` :
+        il porte sur les 5 ventes voisines retenues par le score (au moins
+        1 000 €, surface bâtie de 10 à 1 000 m²), quels que soient `limit`
+        et les filtres, qui ne changent que `matches`.
 
         Filtres optionnels :
           - limit : 1-5, default 3
@@ -307,45 +342,55 @@ class _PermitsResource:
             params["min_year"] = min_year
         if max_distance is not None:
             params["max_distance"] = max_distance
-        return self._c._get(f"/v1/permits/{num_pa}/dvf", params=params or None)
+        return self._c._get(
+            f"/v1/permits/{num_pa}/dvf",
+            params={**params, **(_params_type(type) or {})} or None,
+        )
 
-    def score_mdb(self, num_pa: str) -> dict[str, Any]:
+    def score_mdb(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/score : Score Opportunité MDB v0.3.
 
-        Formules Régional et plus (402 pour Gratuit et Explorer).
+        Formules Régional et plus (402 pour Gratuit, Découverte et Explorateur).
         Retourne {num_pa, permit_id, score (0-100), tier (low / medium /
         high / premium), components, weights, version, method}.
 
-        Quand le score est déjà pré-calculé (cas le plus fréquent,
-        `method="materialise (precomputed)"`), `components` et `weights`
-        valent `None` : le détail des 11 signaux (type, surface,
-        dvf_value, dep_activity, demandeur, dvf_coherence, density, plu,
-        risk, sirene, building_density) est alors donné par
-        `GET /v1/permits/{num_pa}/score/explain`. En calcul à la demande,
-        la réponse ajoute `dvf_matches_used` et `density_class`.
+        `components` donne la note 0-100 de chacun des 11 signaux (type,
+        surface, dvf_value, dep_activity, demandeur, dvf_coherence,
+        density, plu, risk, sirene, building_density) et `weights` leur
+        poids ; la réponse ajoute `dvf_matches_used`,
+        `dvf_median_price_per_m2`, `dvf_median_sample_size` et
+        `density_class`. Une explication en français de chaque signal est
+        donnée par `GET /v1/permits/{num_pa}/score/explain`.
         """
-        return self._c._get(f"/v1/permits/{num_pa}/score")
+        return self._c._get(f"/v1/permits/{num_pa}/score", params=_params_type(type))
 
-    def risks(self, num_pa: str) -> dict[str, Any]:
+    def risks(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/risks : Georisques BRGM (commune-level).
 
-        Formules Régional et plus (402 pour Gratuit et Explorer). Source :
+        Formules Régional et plus (402 pour Gratuit, Découverte et Explorateur). Source :
         API Géorisques (ministère de la Transition écologique et BRGM).
 
         Retourne {num_pa, comm_code, risk_score (0-100), risk_tier (low/
-        moderate/high/critical), risks: [{code, label, has_ppr, ppr_type}],
-        icpe_proches: [{nom, regime, distance_m, activite}], fetch_errors,
-        source, fetched_at, disclaimer}.
+        moderate/high/critical), risk_tier_label (faible, modéré, élevé,
+        critique), risk_summary, risk_reasons, risks: [{code, label,
+        has_ppr, ppr_type}], icpe_proches: [{nom, regime, distance_m,
+        activite}], fetch_errors, source, fetched_at, disclaimer}.
+
+        `risk_reasons` dit d'où viennent les points (un risque recensé pour
+        la commune, les sites Seveso à moins de 2 km) ; `has_ppr` : True si
+        la commune a un plan de prévention opposable sur ce risque (archive
+        GASPAR, `ppr_lu_le`, `ppr_type`, `ppr_nom` ; points x1,5), False
+        sinon, None si non vérifié.
 
         En cas d'erreur partielle (ex: ICPE OK mais /risques 500), retourne
         ce qui marche + liste les endpoints qui ont fail dans `fetch_errors`.
         """
-        return self._c._get(f"/v1/permits/{num_pa}/risks")
+        return self._c._get(f"/v1/permits/{num_pa}/risks", params=_params_type(type))
 
-    def plu(self, num_pa: str) -> dict[str, Any]:
+    def plu(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/plu : zonage urbanisme PLU au point geocode.
 
-        Formules Régional et plus (402 pour Gratuit et Explorer). Source :
+        Formules Régional et plus (402 pour Gratuit, Découverte et Explorateur). Source :
         Géoportail de l'Urbanisme via apicarto.ign.fr.
 
         Retourne {num_pa, lat, lng, has_plu, zonage : {code (UA/UB/AU/A/N..),
@@ -355,9 +400,9 @@ class _PermitsResource:
         Si la commune n'a pas de PLU numérisé sur le Géoportail,
         `has_plu=False` avec `not_covered_reason` explicite.
         """
-        return self._c._get(f"/v1/permits/{num_pa}/plu")
+        return self._c._get(f"/v1/permits/{num_pa}/plu", params=_params_type(type))
 
-    def full_view(self, num_pa: str) -> dict[str, Any]:
+    def full_view(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/360 : vue agregee 6-en-1 en 1 appel HTTP.
 
         Combine en 1 reponse : detail + sirene + dvf + score + plu + risks.
@@ -366,7 +411,7 @@ class _PermitsResource:
         apicarto + Risks BRGM).
 
         Coût quota : 6 unités pour les formules Régional, Pro, Business
-        et Enterprise ; 1 unité pour Gratuit et Explorer, qui reçoivent
+        et Entreprise ; 1 unité pour Gratuit, Découverte et Explorateur, qui reçoivent
         seulement `detail` (autres champs `None`, et
         `plan_required_for_full="pro"` alors que Régional suffit).
 
@@ -379,10 +424,10 @@ class _PermitsResource:
         Returns:
             dict avec cles : num_pa, detail, sirene, dvf, score, plu,
             risks, fetch_errors (list), subfetches_billed (int).
-            Pour Gratuit et Explorer : `plan_required_for_full` est
+            Pour Gratuit, Découverte et Explorateur : `plan_required_for_full` est
             présent et toutes les sous-parties sauf `detail` sont None.
         """
-        return self._c._get(f"/v1/permits/{num_pa}/360")
+        return self._c._get(f"/v1/permits/{num_pa}/360", params=_params_type(type))
 
     def score_feedback(
         self,
@@ -397,7 +442,7 @@ class _PermitsResource:
     ) -> dict[str, Any]:
         """POST /v1/score/feedback : envoyer un feedback sur un Score MDB.
 
-        Formules Régional et plus (402 pour Gratuit et Explorer). Le
+        Formules Régional et plus (402 pour Gratuit, Découverte et Explorateur). Le
         retour est enregistré et transmis par e-mail à l'équipe.
 
         Args:
@@ -435,10 +480,10 @@ class _PermitsResource:
         etat_pa: int | None = None,
         max_rows: int | None = None,
     ) -> bytes:
-        """GET /v1/permits/export : export CSV en masse (Business et Enterprise).
+        """GET /v1/permits/export : export CSV en masse (Business et Entreprise).
 
-        Formules Business et Enterprise uniquement (403 sinon).
-        Cap par defaut : 100k lignes Business, 1M Enterprise. Le user
+        Formules Business et Entreprise uniquement (403 sinon).
+        Cap par defaut : 100k lignes Business, 1M Entreprise. Le user
         peut reduire via `max_rows` mais pas augmenter.
 
         Retourne le contenu CSV brut en bytes UTF-8 (header + rows). Pour
@@ -611,8 +656,8 @@ class PermisAPI:
         Utilise pg_trgm cote DB. Insensible aux accents et a la casse,
         tolerant aux typos courants. Latence ~50-200ms.
 
-        Toutes formules (Gratuit, Explorer, Régional, Pro, Business,
-        Enterprise), dans le périmètre géographique de la formule. Coût
+        Toutes formules (Gratuit, Découverte, Explorateur, Régional, Pro,
+        Business, Entreprise), dans le périmètre géographique de la formule. Coût
         quota : 1 unité par résultat retourné (minimum 1).
 
         Args:
@@ -694,8 +739,8 @@ class _AsyncPermitsResource:
                 return
             page += 1
 
-    async def get(self, num_pa: str) -> dict[str, Any]:
-        return await self._c._get(f"/v1/permits/{num_pa}")
+    async def get(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
+        return await self._c._get(f"/v1/permits/{num_pa}", params=_params_type(type))
 
     async def near(
         self, *, lat: float, lng: float, radius_m: int, **filters: Any
@@ -710,6 +755,7 @@ class _AsyncPermitsResource:
         self,
         num_pa: str,
         *,
+        type: str | None = None,
         limit: int | None = None,
         type_local: str | None = None,
         include_terrains: bool | None = None,
@@ -732,33 +778,36 @@ class _AsyncPermitsResource:
             params["min_year"] = min_year
         if max_distance is not None:
             params["max_distance"] = max_distance
-        return await self._c._get(f"/v1/permits/{num_pa}/dvf", params=params or None)
+        return await self._c._get(
+            f"/v1/permits/{num_pa}/dvf",
+            params={**params, **(_params_type(type) or {})} or None,
+        )
 
-    async def score_mdb(self, num_pa: str) -> dict[str, Any]:
+    async def score_mdb(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/score : version async. Régional et plus."""
-        return await self._c._get(f"/v1/permits/{num_pa}/score")
+        return await self._c._get(f"/v1/permits/{num_pa}/score", params=_params_type(type))
 
-    async def plu(self, num_pa: str) -> dict[str, Any]:
+    async def plu(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/plu : version async. Régional et plus.
         Voir _PermitsResource.plu pour la doc complete."""
-        return await self._c._get(f"/v1/permits/{num_pa}/plu")
+        return await self._c._get(f"/v1/permits/{num_pa}/plu", params=_params_type(type))
 
-    async def risks(self, num_pa: str) -> dict[str, Any]:
+    async def risks(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/risks : version async. Régional et plus.
         Voir _PermitsResource.risks pour la doc complete."""
-        return await self._c._get(f"/v1/permits/{num_pa}/risks")
+        return await self._c._get(f"/v1/permits/{num_pa}/risks", params=_params_type(type))
 
-    async def parcelle(self, num_pa: str) -> dict[str, Any]:
+    async def parcelle(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/parcelle : version async. Régional et plus.
         Voir _PermitsResource.parcelle pour la doc complete."""
-        return await self._c._get(f"/v1/permits/{num_pa}/parcelle")
+        return await self._c._get(f"/v1/permits/{num_pa}/parcelle", params=_params_type(type))
 
-    async def batiments_existants(self, num_pa: str) -> dict[str, Any]:
+    async def batiments_existants(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/batiments-existants : version async.
         Régional et plus. Voir _PermitsResource.batiments_existants pour la
         doc complete. Use case marchand de biens : terrain nu vs deja bati."""
         return await self._c._get(
-            f"/v1/permits/{num_pa}/batiments-existants"
+            f"/v1/permits/{num_pa}/batiments-existants", params=_params_type(type)
         )
 
     async def bulk_enrich(
@@ -768,7 +817,7 @@ class _AsyncPermitsResource:
         radius_m: int = 500,
         max_matches: int = 3,
     ) -> dict[str, Any]:
-        """POST /v1/permits/bulk-enrich : version async. Business et Enterprise.
+        """POST /v1/permits/bulk-enrich : version async. Business et Entreprise.
         Voir _PermitsResource.bulk_enrich pour la doc complete."""
         return await self._c._post(
             "/v1/permits/bulk-enrich",
@@ -779,14 +828,14 @@ class _AsyncPermitsResource:
             },
         )
 
-    async def full_view(self, num_pa: str) -> dict[str, Any]:
+    async def full_view(self, num_pa: str, type: str | None = None) -> dict[str, Any]:
         """GET /v1/permits/{num_pa}/360 : version async. Vue agregee 6-en-1.
 
-        Coût quota : 6 unités de Régional à Enterprise, 1 unité pour Gratuit et Explorer.
+        Coût quota : 6 unités de Régional à Entreprise, 1 unité pour Gratuit, Découverte et Explorateur.
         Le header `X-RateLimit-Cost` confirme le cout. Voir
         _PermitsResource.full_view pour la doc complete.
         """
-        return await self._c._get(f"/v1/permits/{num_pa}/360")
+        return await self._c._get(f"/v1/permits/{num_pa}/360", params=_params_type(type))
 
     async def score_feedback(
         self,
@@ -824,7 +873,7 @@ class _AsyncPermitsResource:
         etat_pa: int | None = None,
         max_rows: int | None = None,
     ) -> bytes:
-        """GET /v1/permits/export : version async. Business et Enterprise.
+        """GET /v1/permits/export : version async. Business et Entreprise.
         Voir _PermitsResource.export pour la doc complete des params."""
         params: dict[str, Any] = {}
         if dep_code is not None:

{permisapi_client-0.8.1 → permisapi_client-0.9.1}/permisapi_client/exceptions.py

@@ -27,7 +27,7 @@ class PermisAPIUnauthorized(PermisAPIError):
 
 class PermisAPIForbidden(PermisAPIError):
     """403 : accès refusé (compte désactivé, département ou historique
-    hors de votre formule, export réservé à Business et Enterprise)."""
+    hors de votre formule, export réservé à Business et Entreprise)."""
 
 
 class PermisAPIRateLimited(PermisAPIError):

{permisapi_client-0.8.1 → permisapi_client-0.9.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "permisapi-client"
-version = "0.8.1"
+version = "0.9.1"
 description = "Client Python officiel pour PermisAPI : permis de construire de France en API REST."
 readme = "README.md"
 requires-python = ">=3.9"

{permisapi_client-0.8.1 → permisapi_client-0.9.1}/tests/test_client.py

@@ -520,3 +520,34 @@ def test_custom_http_client() -> None:
     client = PermisAPI(api_key="pk_test_xyz", client=h)
     assert client._http is h
     client.close()
+
+
+# Argument facultatif `type` (05/11/2026) : un même numéro peut porter
+# plusieurs autorisations (un PC et un PD, par exemple).
+@respx.mock
+def test_type_passe_en_parametre() -> None:
+    route = respx.get(f"{BASE}/v1/permits/0330632600176").respond(json={"num_pa": "0330632600176"})
+    dvf = respx.get(f"{BASE}/v1/permits/0330632600176/dvf").respond(json={"matches": []})
+    with PermisAPI(api_key="pk_test_abc") as client:
+        client.permits.get("0330632600176", type="pd")
+        client.permits.dvf("0330632600176", type="PD", limit=2)
+        client.permits.get("0330632600176")
+    assert route.calls[0].request.url.params["type"] == "PD"
+    assert "type" not in route.calls[1].request.url.params
+    assert dvf.calls.last.request.url.params["type"] == "PD"
+    assert dvf.calls.last.request.url.params["limit"] == "2"
+
+
+def test_type_inconnu_refuse() -> None:
+    with PermisAPI(api_key="pk_test_abc") as client:
+        with pytest.raises(ValueError):
+            client.permits.get("0330632600176", type="CU")
+
+
+@respx.mock
+@pytest.mark.asyncio
+async def test_type_async() -> None:
+    route = respx.get(f"{BASE}/v1/permits/0330632600176/360").respond(json={"num_pa": "0330632600176"})
+    async with AsyncPermisAPI(api_key="pk_test_abc") as client:
+        await client.permits.full_view("0330632600176", type="PA")
+    assert route.calls.last.request.url.params["type"] == "PA"