Référence API

Intégrez la détection de doublons True Record dans vos workflows via l'API REST.

URL de base

https://truerecord.app/api/v1

Toutes les requêtes API nécessitent un token Bearer.

Format de l'en-tête Authorization

Authorization: Bearer tr_xxxxxxxxxxxxxxxx

Les clés API sont limitées à des permissions spécifiques.

Scope	Description
`scans:read`	Voir le statut des scans
`scans:write`	Lancer des scans
`matches:read`	Voir les correspondances
`matches:merge`	Fusionner
`matches:dismiss`	Rejeter les correspondances
`import:read`	Voir les imports
`import:write`	Exécuter des imports
`org:read`	Voir les infos org
`*`	Accès complet

GET/org/status

Récupérer les informations de l'organisation.

Scope: org:read

POST/scan/start

Lancer un nouveau scan.

Scope: scans:write

GET/scan/status/:scanId

Récupérer les résultats du scan.

Scope: scans:read

GET/matches

Récupérer les correspondances.

Scope: matches:read

POST/matches/:matchId/merge

Fusionner une correspondance.

Scope: matches:merge

POST/matches/:matchId/dismiss

Rejeter une correspondance.

Scope: matches:dismiss

Les limites varient selon le plan :

Les en-têtes de limite sont inclus dans chaque réponse.

Toutes les erreurs suivent un format cohérent :

400Bad Request - Paramètres invalides

401Unauthorized - Clé API invalide

403Forbidden - Permissions insuffisantes

404Not Found - Ressource inexistante

429Too Many Requests - Limite dépassée

500Internal Server Error

Ressources