 |
API Sirene - Documentation des services |
 |
Interrogation unitaire du siret : Appel du service
Il s’agit d’un service web de type REST, qui s’appuie donc uniquement sur les protocoles et standards utilisés sur le web. L’invocation du service se fait par envoi d’une requête HTTPS (de type GET) sur une URL publique ; le résultat est communiqué dans le contenu de la réponse HTTPS.
L’appel utilise la clé d’accès fourni par le catalogue.
URL d’accès au service avec recherche de la totalité des périodes historiques :
https://api.insee.fr/api-sirene/3.11/siret/{siret}
URL d’accès au service avec le paramètre date qui renvoie uniquement la période comprenant cette date :
https://api.insee.fr/api-sirene/3.11/siret/{siret}?date={date}
Interrogation unitaire du siret : Paramètres
{siret} est un numéro à 14 chiffres : paramètre obligatoire.
{date} est de la forme AAAA-MM-JJ : paramètre facultatif.
Interrogation unitaire du siret : En-tête de la requête
L’authentification se fait en passant votre clé d’accès par l’en-tête Authorization.
Le seul format de données produit correspond à Accept application/json.
Le contenu de la réponse peut être compressé afin de limiter sa taille. L'algorithme de compression utilisé est le gzip.
Pour recevoir une réponse compressée, il faut ajouter dans l'en-tête HTTP le paramètre Accept-Encoding et le valoriser à gzip.