--- title: Vue d'ensemble description: Guide étape par étape pour intégrer Human Token — de l'authentification à la récupération de votre premier humanToken. canonical: https://developer.unico.io/fr/human-token/api-reference/overview locale: fr generated_by: markdown-export --- - [/fr/](/fr/) - Référence API - Vue d'ensemble **Sur cette pageVue d'ensemble de la API ReferenceTout ce dont vous avez besoin pour passer de zéro à votre premier humanToken. Human Token dispose de trois endpoints. Cette page montre comment ils s'articulent pour que vous puissiez commencer l'intégration immédiatement. ### URL de base​ EnvironnementURL de base**Production**`https://humantoken.unico.app` Toutes les requêtes nécessitent l'en-tête `x-unico-accesskey`. Consultez [Authentification](/fr/human-token/get-started/authentication) pour générer votre clé. ### Flux de démarrage rapide​ ### Étape 1 — Authentification​ Générez votre `x-unico-accesskey` dans le [Human Dashboard](https://dashboard.unico.app) ou via l'[Authentication API](/fr/human-token/get-started/authentication). Chaque requête ci-dessous utilise cette clé. ``` x-unico-accesskey: uip_ak.prod.a1b2c3d4.e5f6g7h8.i9j0k1l2 ``` ### Étape 2 — Créer un processus​ Appelez [Create Process](/fr/human-token/api-reference/post-processes) pour démarrer la vérification. Choisissez l'un des deux modèles : ModèleFlowsFonctionnement**API Only**`api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation`Votre backend envoie le selfie en tant que `imageBase64`. Le `humanToken` est retourné dans la même réponse.**Human Token Journey**`humantoken`, `humantoken+revalidation`L'utilisateur effectue la capture sur la plateforme Unico. Vous obtenez un `token` et un `link` pour présenter le journey, puis récupérez le résultat avec Get Process. **Exemple API Only :** ``` curl -X POST https://humantoken.unico.app/client/v1/process \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \ -H "Content-Type: application/json" \ -d '{ "flow": "api+humantoken", "imageBase64": "", "companyBranchId": "" }' ``` **Exemple Human Token Journey :** ``` curl -X POST https://humantoken.unico.app/client/v1/process \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \ -H "Content-Type: application/json" \ -d '{ "flow": "humantoken", "callbackUri": "https://yourapp.com/callback", "companyBranchId": "" }' ``` Consultez [Create Process](/fr/human-token/api-reference/post-processes) pour tous les flows, paramètres et détails de réponse. ### Étape 3 — Présenter le journey à l'utilisateur (flows Journey uniquement)​ Pour les flows `humantoken` et `humantoken+revalidation`, la réponse de Create Process inclut : **`token`** — initialise le [Web SDK](/fr/human-token/integrations/web/web-integration/) ou l'intégration native **`link`** — URL vers laquelle rediriger l'utilisateur Choisissez l'intégration adaptée à votre plateforme : PlateformeApproche**Web — SDK**Intégrez le journey en ligne avec `idpay-b2b-sdk` → [Web Integration](/fr/human-token/integrations/web/web-integration/)**Web — Redirect**Redirigez l'utilisateur vers `link` → [Web Integration](/fr/human-token/integrations/web/web-integration/)**Android**Custom Tabs → [Android](/fr/human-token/integrations/app/android)**iOS**ASWebAuthenticationSession → [iOS](/fr/human-token/integrations/app/ios)**Ionic**Capacitor plugin → [Ionic](/fr/human-token/integrations/app/ionic)**React Native**Native module → [React Native](/fr/human-token/integrations/app/react-native)**Flutter**Platform Channels → [Flutter](/fr/human-token/integrations/app/flutter) Lorsque le journey se termine, l'utilisateur revient à votre `callbackUri`. Passez à l'étape 4. Flows API OnlyIgnorez cette étape — le résultat se trouve déjà dans la réponse de Create Process. ### Étape 4 — Récupérer le résultat (flows Journey uniquement)​ Appelez [Get Process](/fr/human-token/api-reference/get-process) avec l'`id` du processus pour récupérer le résultat : ``` curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" ``` La réponse inclut `data.humanToken.value` (flows standard) ou `data.humanTokenMatch` (flows de revalidation). Consultez [Get Process](/fr/human-token/api-reference/get-process) pour le schéma de réponse complet et les valeurs d'état. ### Étape 5 — Utiliser le humanToken​ Le `humanToken` est un identifiant stable et opaque (jusqu'à 100 caractères). La même personne est toujours résolue vers la même valeur. ``` const { humanToken } = process.data;if (!humanToken?.value) { // Inconclusive — retry or reject per your business rules return;}const existing = await db.persons.findByHumanToken(humanToken.value);if (existing) { // Same person seen before — returning user or duplicate} else { // First time — create a new record await db.persons.create({ humanToken: humanToken.value });} ``` avertissementVérifiez toujours que `data.humanToken.value` n'est pas vide avant de le stocker ou de le comparer. ### Étape 6 — Récupérer le selfie (optionnel)​ Appelez [Get Selfie](/fr/human-token/api-reference/get-selfie) pour télécharger l'image capturée. Le selfie est disponible pendant **24 heures** après la fin du processus — après quoi il est définitivement supprimé. ``` curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" ``` Consultez [Get Selfie](/fr/human-token/api-reference/get-selfie) pour les détails de réponse et les codes d'erreur. ### Endpoints en un coup d'œil​ MéthodeEndpointDescription`POST``/client/v1/process`[Create Process](/fr/human-token/api-reference/post-processes) — démarrer une vérification`GET``/client/v1/process/{processId}`[Get Process](/fr/human-token/api-reference/get-process) — récupérer le résultat`GET``/client/v1/process/{processId}/selfie`[Get Selfie](/fr/human-token/api-reference/get-selfie) — télécharger le selfie (24 h) ### Prochaines étapes​ [Create Process](/fr/human-token/api-reference/post-processes) — référence complète des paramètres pour les cinq flows [Authentication](/fr/human-token/get-started/authentication) — générer et gérer vos clés d'accès [Build With LLM](/fr/human-token/api-reference/build-with-llm) — collez un prompt dans votre assistant IA pour générer l'intégration complète Dernière mise à jour le 22 oct. 2026**