API Sirene - Documentation des services

retour au sommaire

---

Service informations : codes retour, en-tête et variables de la réponse

Codes retour

Les codes renvoyés par les services sont conformes aux spécifications HTTP :

• 200 - OK : information trouvée, les caractéristiques sont fournies dans le contenu de la réponse ;
• 401 - Unauthorized :jeton d'accès manquant ou invalide ;
• 406 - Not acceptable : le paramètre ‘Accept’ de l’en-tête http contient une valeur non prévue ;
• 429 - Too Many Requests : vous avez dépassé votre quota d’interrogations ;
• 500 - Internal Server Error : erreur interne du serveur ;
• 503 - Service Unavailable : service indisponible.

En-tête de la réponse

L’en-tête de la réponse comprend :
• Access-Control-Allow-Origin: *
• Cache-Control: private
• Connection: Keep-Alive
• Content-Encoding: gzip
• Content-Length: xxx
• Content-Type: application/json;charset=utf-8
• Date: xxx
• Expires: Thu, 01 Jan 1970 01:00:00 GMT
• Keep-Alive: timeout=5, max=100
• Server: unknown
• Vary: Accept-Encoding
• X-Frame-Options: SAMEORIGIN

Variables de la réponse

Variable	Contenu	Commentaire
etatService	Etat actuel du service	UP ou DOWN
Pour chaque collection exposée : etatsDesServices
collection	Nom de la collection	Unités Légales, Établissements, Liens de succession ou Refus d'immatriculation au RCS
etatCollection	Etat actuel de chaque collection	UP ou DOWN
Variable	Contenu	Commentaire
versionService	Numéro de la version API Sirene	x.x.x
journalDesModifications	Historique des versions de l'API Sirene	URL changelog.txt
Pour chaque collection exposée : datesDernieresMisesAJourDesDonnees
collection	Nom de la collection	Unités Légales, Établissements, Liens de succession ou Refus d'immatriculation au RCS
dateDerniereMiseADisposition	Date et heure de la dernière mise à disposition des données de la collection	AAAA-MM-JJTHH:MM:SS
dateDernierTraitementMaximum	Date correspondant à la date de validité des données consultées	AAAA-MM-JJTHH:MM:SS
dateDernierTraitementDeMasse	Date du dernier traitement de masse sur la collection. À cette date plusieurs centaines de milliers de documents ont pu être mis à jour. Il est conseillé de traiter cette date d'une manière spécifique	AAAA-MM-JJ

Exemple

Requête unique (Requête au 15.04.2022) :
https://api.insee.fr/entreprises/sirene/V3/informations

{
    "etatService": "UP",
    "etatsDesServices": [
        {
            "Collection": "Unités Légales",
            "etatCollection": "UP"
        },
        {
            "Collection": "Établissements",
            "etatCollection": "UP"
        },
        {
            "Collection": "Liens de succession",
            "etatCollection": "UP"
        },
        {
            "Collection": "Refus d'immatriculation au RCS",
            "etatCollection": "UP"
        }
    ],
    "versionService": "3.9.21",
    "journalDesModifications": "https://api.insee.fr/registry/resource/_system/governance/apimgt/applicationdata/provider/insee/Sirene/V3/documentation/files/changelog.txt",
    "datesDernieresMisesAJourDesDonnees": [
        {
            "collection": "Unités Légales",
            "dateDerniereMiseADisposition": "2022-04-15T00:28:15",
            "dateDernierTraitementMaximum": "2022-04-14T22:38:17",
            "dateDernierTraitementDeMasse": "2021-10-27"
        },
        {
            "collection": "Établissements",
            "dateDerniereMiseADisposition": "2022-04-15T01:46:37",
            "dateDernierTraitementMaximum": "2022-04-14T22:38:17",
            "dateDernierTraitementDeMasse": "2021-10-27"
        },
        {
            "collection": "Liens de succession",
            "dateDerniereMiseADisposition": "2022-04-15T01:47:28",
            "dateDernierTraitementMaximum": "2022-04-14T21:13:27",
            "dateDernierTraitementDeMasse": null
        },
        {
            "collection": "Refus d'immatriculation au RCS",
            "dateDerniereMiseADisposition": "2022-04-15T01:54:46",
            "dateDernierTraitementMaximum": "2022-04-14T04:10:34",
            "dateDernierTraitementDeMasse": null
        }
    ]
}

Commentaires

La requête au 15.04.2022 montre que tous les services sont disponibles (UP). Les variables dateDerniereMiseADisposition montrent que la mise à jour des données de l'API s'est bien faite normalement, dans la nuit précédente.
Le sercice informations est disponible sur la console. Pour en savoir plus

Haut de page

---