--- title: Créer un processus description: Créez un processus Human Token sur l'Human API (envoyez un selfie en API Only ou démarrez la Human Token Journey) et obtenez le humanToken dans data.humanToken. canonical: https://developer.unico.io/fr/human-token/api-reference/post-processes locale: fr generated_by: markdown-export --- - [/fr/](/fr/) - Référence API - Créer un processus **Sur cette pageCréer un processusPOSTCréez un processus Human Token depuis votre back-end et obtenez le humanToken dans data.humanToken. Human Token s'exécute sur l'endpoint `POST /client/v1/process` de l'Human API. Avec les flux API Only (`api+humantoken`, `api+liveness+humantoken` et `api+liveness+humantoken+revalidation`), le processus est créé et finalisé en un seul appel : la réponse contient déjà le résultat dans `data.humanToken`. Avec les flux Human Token Journey (`humantoken` et `humantoken+revalidation`), la réponse contient l'`id` du processus, un `token` et le `link` du parcours, et le résultat est disponible une fois que l'utilisateur a terminé le parcours. Les flux `+revalidation` nécessitent un tableau `references` contenant un `humanToken` obtenu précédemment pour la revalidation. ### Flux​ Human Token fonctionne selon deux modèles d'intégration : **API Only** — votre back-end envoie le selfie dans `imageBase64`. **Human Token Journey** — l'utilisateur suit le parcours Unico sur le Web et revient à votre `callbackUri`. FlowCapabilitiesPossible resultIntegration componentsrequiredExample`api+humantoken`[Human Token](/fr/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken`Liveness[Human Token](/fr/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken+revalidation`Liveness[Human Token](/fr/human-token/)RevalidationPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`humantoken`Liveness[Human Token](/fr/human-token/)PROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example`humantoken+revalidation`Liveness[Human Token](/fr/human-token/)RevalidationPROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example ### Endpoint​ EnvironnementURL**Production**`POST https://humantoken.unico.app/client/v1/process` ### Requête​ En-têtes En-têteValeur`x-unico-accesskey``` (voir [Authentification](/fr/human-token/get-started/authentication))`Content-Type``application/json` Paramètres du corps ChampTypeRequisDescription`flow`stringouiFlux Human Token : `api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation` (API Only) ou `humantoken`, `humantoken+revalidation` (Human Token Journey). Voir [Flux](#flows).`imageBase64`stringAPI OnlyLe selfie, capturé par votre front-end et envoyé directement, en base64. PNG, JPEG ou WebP, jusqu'à 800 Ko. Suivez le [Standard de capture](/fr/human-token/additional-resources/capture-standard).`callbackUri`stringHuman Token JourneyURL vers laquelle l'utilisateur est redirigé à la fin du parcours.`companyBranchId`stringnonIdentifiant de branche. Lorsqu'il est fourni, le processus utilise la configuration de la branche spécifiée.`references`arrayFlux de revalidationTableau d'objets de référence. Requis pour les flux `+revalidation`. Chaque objet contient `referenceType` (`REFERENCE_TYPE_HUMAN_TOKEN`) et `referenceContent` (la valeur du `humanToken` obtenu précédemment). ### Réponses​ 200 OK ChampTypeDescription`id`string (UUID)Identifiant du processus. Utilisez-le pour récupérer à nouveau le processus via [Récupérer un processus](/fr/human-token/api-reference/get-process).`state`stringÉtat du processus — voir [Interpréter le résultat](#interpreting-the-result). Uniquement dans les flux API Only.`token`stringToken du processus créé, vous pouvez l'utiliser pour ouvrir l'expérience Journey SDK. Uniquement dans les flux Human Token Journey (`humantoken`, `humantoken+revalidation`).`link`stringURL de la Human Token Journey : envoyez l'utilisateur vers celle-ci. Uniquement dans les flux Human Token Journey (`humantoken`, `humantoken+revalidation`).`data.​humanToken.​value`stringIdentifiant stable et opaque du visage (jusqu'à 100 caractères). La même personne correspond toujours à la même valeur. Uniquement dans les flux API Only (hors revalidation).`data.​humanTokenMatch`string`"true"` si le selfie correspond au `humanToken` référencé, `"false"` sinon. Uniquement dans le flux `+revalidation` API Only. Interpréter le résultat `state`SignificationQue faire`PROCESS_STATE_FINISHED``data.humanToken.value` renseigné : personne réelle, avec un Human Token.Recherchez `value` dans vos enregistrements : s'il existe, il s'agit d'un utilisateur récurrent ou d'un doublon possible ; sinon, il s'agit d'une nouvelle personne.`PROCESS_STATE_FINISHED`Pas de `data.humanToken`, ou `value` vide : non concluant.Considérez-le comme non concluant. Ne stockez ni ne comparez jamais une `value` vide ; relancez le processus ou rejetez-le, selon vos règles métier.`PROCESS_STATE_FAILED`Échec du processus d'identification.Relancez le processus ou rejetez-le, selon vos règles métier.`PROCESS_STATE_CREATED`Processus créé.Patientez. Récupérez le résultat plus tard via [Récupérer un processus](/fr/human-token/api-reference/get-process).`PROCESS_STATE_CANCELED`Le processus a été annulé.Créez un nouveau processus, si l'utilisateur doit encore être vérifié. avertissementVérifiez toujours que `data.humanToken.value` n'est pas vide avant de l'utiliser. ### Codes d'erreur​ remarqueLe statut HTTP renvoyé lorsque la clé d'accès dans l'en-tête `x-unico-accesskey` est absente ou invalide est encore en cours de confirmation. Voir [Authentification](/fr/human-token/get-started/authentication). 400 Bad Request403 Forbidden429 Too Many Requests500 Internal Server ErrorCodeMessageDescription`3`invalid flowLorsque le flux spécifié n'existe pas.`3`INVALID_IMAGELorsque l'image n'est pas un base64 valide ou ressemble à une tentative d'injection.`3`IMAGE_TOO_LARGELorsque l'image dépasse la taille maximale de 800 Ko.`3`UNSUPPORTED_IMAGE_FORMATLorsque le format de l'image n'est pas PNG, JPEG ou WebP.`3`MISSING_IMAGELorsque l'image est requise pour ce flux et n'a pas été envoyée.`3`INVALID_REQUESTLorsque le corps de la requête est nul ou ne peut pas être interprété.`9`monthly process limit of reached for this tenantLorsque la limite d'utilisation mensuelle a été atteinte.`9`PROCESS_FAILEDLorsque le processus a atteint un échec terminal lors de sa création.CodeMessageDescription`7`PERMISSION_DENIEDLorsque les identifiants sont valides mais ne donnent pas droit à cette action.Limite de débit atteinte. Lorsque votre système reçoit une erreur HTTP 429, vous devez implémenter des mécanismes pour prévenir les défaillances en cascade et éviter d'aggraver la restriction. **Bonnes pratiques :** **Période de repos (backoff) :** Arrêtez ou réduisez immédiatement les requêtes suivantes de votre système. Ne réessayez pas continuellement les requêtes échouées dans une boucle serrée. **File d'attente et limitation (Queueing & throttling) :** Mettez en mémoire tampon ou en file d'attente les requêtes sortantes de votre côté pour contrôler le flux de trafic avant de les renvoyer. **Backoff exponentiel avec jitter :** Lors des nouvelles tentatives, augmentez le temps d'attente de manière exponentielle entre les essais (par exemple, 1 s, 2 s, 4 s, 8 s) et ajoutez un petit délai aléatoire ("jitter") pour éviter un effet de troupeau où toutes les requêtes en file d'attente réessaient exactement à la même milliseconde. avertissementEnvoyer continuellement des requêtes vers un endpoint soumis à une limite de débit sans appliquer de backoff peut **prolonger la période de restriction** et impacter sévèrement le débit opérationnel de votre système. Limiter correctement les requêtes de votre côté garantit une intégration plus fluide et plus résiliente. Pour les limites par défaut, l'augmentation des requêtes et des détails supplémentaires, consultez [Limites de débit](/fr/developers/start/rate-limits).CodeMessageDescription`13`Internal failure! Try again laterLorsqu'une erreur interne se produit. Pour la liste complète des codes de cet endpoint, consultez la référence [Créer un processus](/fr/developers/api-reference/post-processes#error-codes) de l'Human API. ### Prochaines étapes​ Stockez la valeur `humanToken` avec votre enregistrement utilisateur pour reconnaître la même personne lors des appels Human Token ultérieurs. Pour récupérer à nouveau le processus, à des fins d'audit ou de support, utilisez [Récupérer un processus](/fr/human-token/api-reference/get-process). Dernière mise à jour le 22 oct. 2026**