--- title: Démarrage rapide description: Exécutez Human Plugin et une base de données PostgreSQL avec Docker, créez un processus Human Token et relisez-le avec curl. canonical: https://developer.unico.io/fr/human-plugin/get-started/quickstart locale: fr generated_by: markdown-export --- # Démarrage rapide D'un hôte vide à votre premier processus créé puis récupéré, en quelques minutes. Cette page exécute Human Plugin avec un conteneur PostgreSQL jetable pour un démarrage rapide dans votre environnement. Pour le déployer, voir [Docker Compose](/fr/human-plugin/self-hosting/docker-compose) ou [Kubernetes](/fr/human-plugin/self-hosting/kubernetes). ## Prérequis - Docker 24 ou version ultérieure, sur `linux/amd64` ou `linux/arm64` (Docker Desktop sur macOS fonctionne). - Les identifiants du registre et la clé d'accès fournis par Unico. Voir [Prérequis et accès](/fr/human-plugin/get-started/prerequisites). ## 1. Récupérer l'image Connectez-vous au registre de Unico avec votre nom d'utilisateur et votre token, une fois par hôte : ```bash echo "" | docker login pkg.unico.run -u --password-stdin ``` ```bash docker pull pkg.unico.run/human-plugin-api:latest ``` ## 2. Démarrer PostgreSQL et Human Plugin ```bash docker network create human-plugin ``` ```bash docker run -d --name human-plugin-db --network human-plugin \ -e POSTGRES_USER=human_plugin -e POSTGRES_PASSWORD=human_plugin -e POSTGRES_DB=human_plugin \ postgres:16 ``` Définissez votre clé d'accès dans le shell, puis démarrez Human Plugin : ```bash export HUMAN_API_ACCESS_KEY='' ``` ```bash docker run -d --name human-plugin --network human-plugin --stop-timeout 60 -p 127.0.0.1:8080:8080 \ -e HUMAN_API_ACCESS_KEY \ -e POSTGRES_ADDRESS_HOST=human-plugin-db \ -e POSTGRES_USER=human_plugin \ -e POSTGRES_PASSWORD=human_plugin \ -e POSTGRES_SSL_MODE=disable \ pkg.unico.run/human-plugin-api:latest ``` `POSTGRES_SSL_MODE=disable` ne convient qu'à cette base locale. Conservez la valeur par défaut, `require`, pour toute autre base. Voir [Configuration](/fr/human-plugin/self-hosting/configuration). Vérifiez que Human Plugin est prêt : ```bash curl --fail http://127.0.0.1:8080/health/ready ``` Vous devriez voir `{"status":"ok"}`. Si la commande échoue, `docker logs human-plugin` en indique la cause. ## 3. Créer un processus Choisissez l'un des [flux](/fr/human-plugin/api-reference/create-process#flows). `clientId`, `correlationId` et `credential` sont identiques dans tous les flux. ### humantoken (la personne capture) La personne prend le selfie dans le parcours de capture. La réponse contient le `link` vers ce parcours. ```bash curl -s -X POST http://127.0.0.1:8080/v1/processes \ -H 'Content-Type: application/json' \ -d '{ "flow": "humantoken", "clientId": "client-a", "correlationId": "quickstart-001", "credential": { "type": "DUI_TYPE_NG_BVN", "value": "" }, "callbackUri": "https://example.com/callback" }' ``` ```json { "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "token": "", "link": "https://…" } ``` Ouvrez le `link` sur un téléphone et prenez le selfie. Le `token` et le `link` ne sont renvoyés qu'ici : Human Plugin ne les stocke pas. ### api+humantoken (vous envoyez le selfie) Votre back-end dispose déjà du selfie et l'envoie dans `imageBase64`. La réponse est définitive, avec le Human Token et l'intelligence. ```bash curl -s -X POST http://127.0.0.1:8080/v1/processes \ -H 'Content-Type: application/json' \ -d '{ "flow": "api+humantoken", "clientId": "client-a", "correlationId": "quickstart-002", "credential": { "type": "DUI_TYPE_NG_BVN", "value": "" }, "imageBase64": "" }' ``` ```json { "id": "5d1f7c2e-1b8a-4e0f-9a4b-2f6c3d9e8a71", "state": "PROCESS_STATE_FINISHED", "data": { "humanToken": { "value": "6d3d71…", "status": "validated" }, "ndocs": { "distinctClientsCount": 1, "transactionsCount": 1, "firstSeen": "2026-11-03", "lastSeen": "2026-11-03", "credentials": [ { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 } ] } } } ``` - `id` est l'identifiant propre à Human Plugin pour le processus. Conservez-le : c'est le seul moyen de relire le processus plus tard. - `correlationId` est votre référence et doit être unique. En réutiliser un renvoie `409 CORRELATION_ID_ALREADY_USED`. - `credential` est le document de la personne. Envoyez `null` s'il n'y en a pas. Les types utilisables figurent dans le [catalogue d'attributs](/fr/human-plugin/additional-resources/attribute-catalog). - `data.humanToken` indique qui est la personne, et `data.ndocs` est l'intelligence sur la personne : ce qu'elle a fait chez vous. Voir [Intelligence](/fr/human-plugin/get-started/intelligence). - Avec un Journey, le processus terminé contient aussi `data.liveness` : `live` lorsque la capture provient d'une personne réelle, `not_live` dans le cas contraire. Voir [Le résultat dans `data`](/fr/human-plugin/api-reference/create-process#result). ## 4. Le relire Remplacez l'identifiant par celui de votre réponse : ```bash curl -s http://127.0.0.1:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801 ``` Un Journey reste en `PROCESS_STATE_CREATED` tant que la personne n'a pas terminé la capture. Relisez-le ensuite : la réponse passe à `PROCESS_STATE_FINISHED`, avec `data.humanToken`, `data.liveness` et `data.ndocs`. Vérifiez que `data.liveness.value` vaut `live` avant de vous fier au résultat. ## 5. Nettoyer ```bash docker rm -f human-plugin human-plugin-db && docker network rm human-plugin ``` ## Suite - [Flux](/fr/human-plugin/api-reference/create-process#flows) : quel flux utiliser et ce que chacun requiert. - [Créer un processus](/fr/human-plugin/api-reference/create-process) : tous les champs et toutes les règles. - [Intégrer votre back-end](/fr/human-plugin/integrations/backend) : quoi stocker et comment gérer les échecs. - [Human Token Journey](/fr/human-plugin/integrations/human-token-journey) : le parcours de capture. - Guides de capture pour [Web](/fr/human-plugin/integrations/web), [Android](/fr/human-plugin/integrations/android), [iOS](/fr/human-plugin/integrations/ios), [Ionic](/fr/human-plugin/integrations/ionic), [React Native](/fr/human-plugin/integrations/react-native) et [Flutter](/fr/human-plugin/integrations/flutter) : le côté front-end de la capture. - [Exécuter Human Plugin dans votre infrastructure](/fr/human-plugin/self-hosting/overview)