API
Une API REST versionnée : /api/v1
Authentification par clé secrète et scopes, JSON partout, pagination par curseur, limites de débit par plan. /api/v2 pourra coexister sans rupture.
| POST | /v1/events | Ingestion d'un événement (idempotent) |
| GET | /v1/events/{id} | Statut et risque d'un événement |
| POST | /v1/emails | Email transactionnel (template ou contenu) |
| GET | /v1/emails/{id} | Statut de délivrance |
| POST | /v1/messages | Message client → conversation |
| GET | /v1/conversations | Liste des conversations |
| GET | /v1/conversations/{id} | Conversation et messages |
| POST | /v1/conversations/{id}/reply | Réponse du client |
| GET | /v1/customers/{id} | Client (ID Nati ou externe) |
| POST | /v1/webhooks | Création d'un endpoint (secret affiché une fois) |
| GET | /v1/audit-logs | Journal d'audit |
| POST | /v1/holds/{id}/confirm | Confirmation d'un hold par votre système |
| POST | /v1/approvals/{id}/verify | Vérification d'un code OTP |
| GET | /v1/knowledge/search | Recherche dans vos connaissances approuvées |
| POST | /v1/tools/{name}/execute | Exécution contrôlée d'un outil Nati Connect |
| POST | /v1/verifications | Vérification d'identité KYC (politique versionnée) |
| GET | /v1/verifications/{id}/result | Décision, statuts d'assurance, motifs |
| POST | /v1/businesses | Vérification d'entreprise (KYB) |
| POST | /v1/signature-requests | Demande de signature électronique |
| POST | /v1/cheques | Émission d'un chèque électronique scellé |
| POST | /v1/cheques/{id}/settle | Encaissement confirmé par votre système |
Erreurs uniformes
type, code, message, request_id — jamais de détail interne.
Traçabilité
X-Request-Id et X-Trace-Id (W3C traceparent accepté) sur chaque réponse.
Environnements
nati_sk_test_ (sandbox) et nati_sk_live_ (production), données isolées.