L'INSEE met à disposition une API pour consulter les propriétés des SIRET enregistrés. Il est nécessaire de créer un compte pour invoquer ses services en HTTP. Suivez leur guide : Insee_API_publique_modalites_connexion.pdf
Vous obtenez une clé (en bas à droite) que vous allez utiliser dans vos transactions.
Vous pouvez tester sur : https://www.data.gouv.fr/dataservices/api-sirene-open-data/
A noter : l'API indique une limitation à 30 transactions par minute pour les usages open data
Dans la section Swagger
- Cliquez sur Authorize et indiquez votre clé.
- Choisissez par exemple GET /siret
/{siret}, cliquez sur "Try it out", - Indiquez un SIRET,
- Pour n'avoir que la période courante précisez une date à 2999-12-31
- Cliquez sur "Execute".
L'interface vous indique la syntaxe "curl" utilisable par exemple dans un script :
curl -X 'GET' \
'https://api.insee.fr/api-sirene/3.11/siret/12345678901234
?date=2999-12-31' \
-H 'accept: application/json' \
-H 'X-INSEE-Api-Key-Integration: 49d299ed-macle-apixx-amoix-ede4826b2b8c'
Et le résultat (code retour HTTP et réponse au format JSON, gérable avec la commande jq si vous en disposez) :
{
"header": {
"statut": 200,
"message": "ok"
},
"etablissement": {
"siren": "123456789",
"nic": "01234",
"siret": "12345678901234",
"statutDiffusionEtablissement": "O",
"dateCreationEtablissement": "2018-08-01",
"trancheEffectifsEtablissement": "32",
...
En plus des données courantes, l'API Sirene donne accès aux variables historisées suivantes :
- La dénomination ;
- Le Nic du siège ;
- Le caractère employeur ;
- Dans la section "periodesEtablissement" l'occurrence en vigueur a sa "dateFin à null".
- On y trouvera son statut dans etatAdministratifEtablissement (A Actif, F Fermé).
Si le SIRET n'est pas attribué c'est un code retour HTTP 404, si vous n'êtes pas authentifié HTTP 401
{
"header": {
"statut": 404,
"message": "Aucun élément trouvé pour le siret 12345678901234"
}
}
{"message":"Unauthorized","http_status_code":401
.
Aucun commentaire:
Enregistrer un commentaire