Vue d'ensemble
Cette section documente le contrat API (connu en interne sous le nom TCA / Check.Integration), utilisé lorsque l'application cliente gère l'étape de capture et envoie l'image directement à la plateforme.
Utilisez le contrat API lorsque :
- Votre application a déjà capturé le selfie ou l'image (via le SDK natif d'Unico ou une solution propriétaire — Capture Standard).
- Vous souhaitez des résultats synchrones dans la réponse de création de processus elle-même.
- Vous ne souhaitez pas rediriger l'utilisateur vers un parcours hébergé.
- Votre architecture privilégie les appels serveur-à-serveur traditionnels (requête → réponse avec le résultat).
Si vous souhaitez qu'Unico héberge le parcours, utilisez plutôt Web & SDK.
Créez un processus de vérification en envoyant directement l'image capturée. Retourne un résultat synchrone.
Récupérez un processus existant du contrat API par son identifiant.
Vérifiez si un utilisateur possède déjà un document réutilisable enregistré avant de démarrer un nouveau flux de capture.
Capturez un nouveau document ou réutilisez un document précédemment capturé lié à un processus biométrique.
Interrogez les données d'enregistrement, le filtrage PEP/AML et les relations sportives pour un CPF donné.
Bibliothèques natives pour Android, iOS et Flutter pour capturer le selfie dans votre application mobile.
Exigences techniques que votre capture propriétaire doit respecter lorsque vous n'utilisez pas le SDK d'Unico — résolution, format, éclairage, et plus encore.
Différences avec Web & SDK
| Aspect | API | Web & SDK |
|---|---|---|
| Création du processus | Après la capture | Avant la capture |
| Retour de l'image | Immédiat (après capture côté client) | Via un point de terminaison dédié |
| Contrôle du parcours | Client | Unico |
| Contrôle de la capture | Client (avec ou sans SDK) | Unico |
| Identification | subject.code | person.duiType + person.duiValue |
| En-têtes | Authorization + APIKEY | Authorization uniquement |
| Schéma de résultat | Plat (unicoId.result, liveness, etc.) | Imbriqué (process.authenticationInfo.*Result) |
Étapes suivantes
- Créer un processus — contrat Onboarding complet.
- Codes d'erreur — gérer les réponses 4xx et 5xx.