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.MMM
dateDernierTraitementMaximum	Date correspondant à la date de validité des données consultées	AAAA-MM-JJTHH:MM:SS.MMM
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-JJTHH:MM:SS.MMM

Exemple

Requête unique (au 26.03.2024) :
https://api.insee.fr/api-sirene/3.11/informations

{
    "header": {
        "statut": 200,
        "message": "OK"
    },
    "etatService": "UP",
    "etatsDesServices": [
        {
            "Collection": "Unités Légales",
            "etatCollection": "UP"
        },
        {
            "Collection": "Établissements",
            "etatCollection": "UP"
        },
        {
            "Collection": "Liens de succession",
            "etatCollection": "UP"
        }
    ],
    "versionService": "3.11.19",
    "journalDesModifications": "https://api.insee.fr/registry/resource/_system/governance/apimgt/applicationdata/provider/insee/Sirene/V3.11/documentation/files/changelog%203.11.txt",
    "datesDernieresMisesAJourDesDonnees": [
        {
            "collection": "Unités Légales",
            "dateDerniereMiseADisposition": "2024-03-26T07:02:52.000",
            "dateDernierTraitementMaximum": "2024-03-26T05:20:08.847",
            "dateDernierTraitementDeMasse": "2024-03-26T05:20:08.847"
        },
        {
            "collection": "Établissements",
            "dateDerniereMiseADisposition": "2024-03-26T14:16:01.000",
            "dateDernierTraitementMaximum": "2024-03-26T07:21:46.628",
            "dateDernierTraitementDeMasse": "2024-03-26T07:21:46.628"
        },
        {
            "collection": "Liens de succession",
            "dateDerniereMiseADisposition": "2024-03-26T11:05:04.000",
            "dateDernierTraitementMaximum": "2024-03-26T10:56:56.543",
            "dateDernierTraitementDeMasse": "2024-03-26T10:56:56.543"
        }
    ]
}

Commentaires

La requête au 26.03.2024 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 service informations est disponible sur la console. Pour en savoir plus

Haut de page

---