Documentation API Registeo

Bienvenue dans la documentation de l'API Registeo. Cette API vous permet d'intégrer le livre de police numérique Registeo directement dans vos outils métier : logiciel de caisse, ERP, application interne, etc.

Accès API

L'accès à l'API est disponible sur demande. Contactez-nous pour activer le mode API sur votre établissement.

Multi-établissement — Une clé API est rattachée à un seul établissement. Si vous gérez plusieurs établissements (multi-SIRET) sur le même compte Registeo, chaque établissement a sa propre clé. Vous basculez entre établissements via le sélecteur dans le header de l'app.

Mode contrôle extérieur

Lorsque l'API est activée pour votre établissement, son registre passe en mode contrôle extérieur :

• Les données du registre (objets, statuts, mouvements) sont mises à jour uniquement via l'API
• L'interface Registeo reste disponible en consultation et pour générer les exports PDF
• La gestion des vendeurs est intégrée aux objets : les informations vendeur sont fournies directement dans chaque objet, pas via un répertoire séparé
• La conformité légale est assurée de la même manière : audit log crypto-chaîné, horodatage, intégrité

Ce mode garantit que votre logiciel métier est la source unique des données du registre, sans risque de double saisie.

Base URL

https://api.registeo.fr/registeo/api

Authentification

Toutes les requêtes doivent inclure votre clé API dans le header X-API-Key :

X-API-Key: rsk_votre_clé_api

La clé est générée par l'équipe Registeo lors de l'activation de votre accès API.

Exemple de requête

# Lister les objets du registre
curl https://api.registeo.fr/registeo/api/objets \
  -H "X-API-Key: rsk_votre_clé_api"

Sections de la documentation

• Objets — Enregistrement et gestion des objets du livre de police
• Export PDF — Génération et envoi du registre en PDF (via l'interface uniquement)
• Audit — Journal d'audit et traçabilité
• Modèles de données — Référence des types et schémas

Hébergement & conformité

• Données hébergées en France
• Conforme aux exigences applicables au livre de police
• Registre traçable avec journal d'audit complet
• Chaque action via l'API est auditée et traçable

Codes d'erreur