--- title: Vue d'ensemble description: Référence pour les API IDCloud — deux contrats publics (Web & SDK et API). canonical: https://developer.unico.io/fr/dual-api/developers/api-reference/ locale: fr generated_by: markdown-export --- - [/fr/](/fr/) - Référence API **Sur cette page# Vue d'ensemble ### Choisir un contrat​ Le choix du contrat est une conséquence de **l'endroit où la capture biométrique se produit** — et non une décision indépendante. Utilisez le tableau ci-dessous comme guide. ContratUtiliser quand…CaptureFlux**[Web & SDK](/fr/dual-api/developers/api-reference/web-sdk)**Le parcours de capture est hébergé par Unico (iFrame Web, Redirection ou SDK natif)Unico contrôleLe processus est créé **avant** la capture → l'utilisateur suit le parcours → le résultat est retourné via callback ou polling**[API](/fr/dual-api/developers/api-reference/api)**Votre application contrôle la capture (avec ou sans le SDK Unico) et envoie l'image directement dans l'appelLe client contrôleL'image est envoyée **avec** la création du processus → le résultat est retourné de manière synchrone ### Hôtes et environnements​ ContratHôte sandboxHôte de productionWeb & SDK`https://api.idcloud.uat.unico.app``https://api.idcloud.unico.app`API`https://api.id.uat.unico.app``https://api.id.unico.app`OAuth2 / Token`https://identityhomolog.acesso.io``https://identity.acesso.io` Détails complets dans [Environnements](/fr/dual-api/developers/api-reference/environments). ### Authentification​ Tous les contrats Unico utilisent un **jeton Bearer (JWT)** obtenu via OAuth2 avec `urn:ietf:params:oauth:grant-type:jwt-bearer`. Détails complets dans [Authentification](/fr/dual-api/developers/api-reference/authentication). ### Différences de payload entre les contrats​ La même opération conceptuelle (« créer un processus de vérification d'identité ») a un aspect différent selon les contrats. Utilisez les tableaux ci-dessous comme référence rapide lors des migrations entre intégrations. Création du processus AspectWeb & SDKAPI**Point de terminaison**`POST /client/v1/process``POST /processes/v1`**Auth**`Authorization: Bearer ``Authorization: Bearer ` + `APIKEY`**Image**Non envoyée (capturée par le parcours Unico)Envoyée sous forme `imageBase64`**Identification de l'utilisateur**`person.duiType` + `person.duiValue``subject.code` (CPF / CURP)**Types de documents**CPF, CURP, SSN, NIN, DNI, NIKCPF, CURP uniquement**Définition du pipeline**`flow` (enum, 30+ valeurs)Implicite dans `APIKEY` (capacités)**Callback**`callbackUri` (redirection utilisateur)Aucun (synchrone)**Webhook**Webhook v1 (résultat final)Webhook v1 (optionnel)**Retourne l'URL du parcours**Oui (`userRedirectUrl`)Non**Résultat**Asynchrone (polling GET ou webhook)Synchrone (dans la réponse)**Jeton SDK**Oui (`token`, `webAppToken`)Non Récupération des résultats AspectWeb & SDKAPI**Point de terminaison**`GET /client/v1/process/\{id\}``GET /processes/v1/\{id\}` (également dans la réponse de création)**Statut**`state` + `result` (enums préfixés)`status` (1, 3, 5)**Structure du résultat**Imbriquée sous `process.authenticationInfo.{capability}Result`. Au Mexique, `idGov` sous `authenticationInfo`.Plate : `unicoId`, `liveness`, `government`, `identityFraudsters`, `idGov` (Mexique uniquement)**Document**`services[].documents[]` (RG/CNH avec OCR)Point de terminaison séparé (`GET /processes/v1/\{id\}/document`) ### Étapes suivantes​ [Authentification](/fr/dual-api/developers/api-reference/authentication) — flux OAuth2 et génération JWT [Environnements](/fr/dual-api/developers/api-reference/environments) — sandbox vs production [Collection Postman](/fr/dual-api/developers/api-reference/postman) — collections prêtes à l'emploi [Webhooks et événements](/fr/developers/webhooks-and-events) — livraison asynchrone des résultats [SDK et outils](/fr/developers/sdks-and-tools/overview) — Web SDK, Android, iOS, Flutter Dernière mise à jour le 8 oct. 2026**