Merge pull request #1378 from betagouv/ajout-api-annuaire-administrat…

…ion-dila

Ajout de l'Api de la DILA "Annuaire Administration : Compétence Géographique des Services Locaux"

_data/api/api-annuaire-administration-competence-geographique-services-locaux.md

@@ -0,0 +1,74 @@
+---
+title: API Annuaire de l’administration - compétence géographique des services locaux
+tagline: Recherchez et consultez les administrations et services publics locaux de proximité.
+is_open: 1
+keywords:
+  - DILA
+  - Annuaire
+  - Administration
+  - Competence
+  - Geographique
+  - Services
+  - Locaux
+themes:
+  - Administration & législation
+  - Annuaire
+  - Administration
+  - Services locaux
+producer: dila
+contact_link: [email protected]
+doc_tech_external: https://api-lannuaire.service-public.fr/explore/dataset/api-lannuaire-administration-locale-competence-geographique/information/
+doc_tech_link: https://api-lannuaire.service-public.fr/api/explore/v2.1/swagger.json
+datagouv_uuid:
+  - 53699fe4a3a729239d206227
+last_update: 24/09/2024
+---
+
+### Contenu des données
+
+La Base de données locales est éditée et diffusée sous la responsabilité de la DILA.
+
+L’API Annuaire de l'administration : compétence géographique des services locaux - Service-Public.fr permet de rechercher et de consulter les administrations et services publics locaux de proximité.
+
+Cette API est libre d’accès et permet de consulter les données de la Bases de données locales par compétence géographique :
+
+- les mairies, les services de l’Etat,
+- les organismes sociaux, etc.
+
+Elle permet de rechercher l’identifiant du service compétent.
+A partir de cet identifiant, il faut utiliser [l’API Annuaire de l’administration et des services publics](https://api-lannuaire.service-public.fr/explore/dataset/api-lannuaire-administration/api) pour obtenir les informations d’adresses, téléphones, site internet, horaires d’ouvertures etc…
+
+### Mise à jour des données
+
+Les données sont mises à jour quotidiennement (jours ouvrés). 
+
+### Nature de l'application
+
+L’API Annuaire de l’administration : compétence géographique des service-locaux - Service-Public.fr est une interface de programmation d’applications permettant d’accéder directement aux données des annuaires de service-public.fr en fonction de critères de sélection prédéfinis.
+Ainsi, les résultats pourront être obtenus au format JSON, CSV ou Excel.
+
+### Utilisation
+
+L’utilisation de l’API Annuaire de l’administration et des services-publics se fait en deux temps :
+
+- Lancement d’une requête d’interrogation/filtrage en passant différents paramètres ;
+- Prévisualisation des premiers résultats ou téléchargement des données complètes.
+
+Les résultats peuvent être obtenus en JSON, CSV et Excel (https://api-lannuaire.service-public.fr/explore/dataset/api-lannuaire-administration-locale-competence-geographique/export).
+
+La description du modèle de données de l’API se trouve [ici](https://api-lannuaire.service-public.fr/explore/dataset/api-lannuaire-administration-locale-competence-geographique/information)
+Une documentation d’aide aux développeurs est disponible [ici](https://api-lannuaire.service-public.fr/explore/dataset/api-lannuaire-administration-locale-competence-geographique/information)
+Pour plus de précisions sur l’utilisation de l'API et pour faciliter l'accès et la réutilisation des données ouvertes, consulter [cette rubrique](https://academy.opendatasoft.com).
+
+### Evolution
+
+Des mises à jour de l’API sont réalisées par l’éditeur OpenDataSoft. Elles sont mises à disposition à l’initiative de la DILA.
+
+### Mise à disposition de l'API
+
+L’API Annuaire de l’administration : compétence géographique des services locaux - Service-Public.fr est disponible sur le site [api-lannuaire-administration-competence-geographique-services-locaux](https://api-lannuaire.service-public.fr/explore/dataset/api-lannuaire-administration-locale-competence-geographique/api) ; [api.dila.fr](https://www.dila.premier-ministre.gouv.fr/services/api) ; elle est également référencée sur [data.gouv.fr](https://www.data.gouv.fr/fr) et sur [api.gouv.fr](https://api.gouv.fr).
+
+### Conditions d’utilisation
+
+L’API Annuaire de l’Administration : compétence géographique des servicces locaux est utilisable gratuitement.
+[Réutilisation des données](https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf) et [Avertissement sur les données personnelles](https://echanges.dila.gouv.fr/OPENDATA/AVERTISSEMENT-Donnees_a_caractere_personnel.pdf) :  voir fiches [Référentiel de l’organisation administrative de l’Etat](https://echanges.dila.gouv.fr/OPENDATA/RefOrgaAdminEtat/Documentation/DILA_RefOrgaAdminEtat_Presentation_20231205.pdf) et [Base de données locales](https://echanges.dila.gouv.fr/OPENDATA/Base_donn%C3%A9es_locales/DILA_BASE_DONNEES_LOCALES_SERVICE-PUBLIC_FR_Presentation_20231205.pdf) du site Service-public.fr.