---
title: क्विकस्टार्ट
description: Docker से Human Plugin और एक PostgreSQL डेटाबेस चलाएँ, एक Human Token प्रोसेस बनाएँ और curl से उसे वापस पढ़ें।
canonical: https://developer.unico.io/hi/human-plugin/get-started/quickstart
locale: hi
generated_by: markdown-export
---

# क्विकस्टार्ट

खाली होस्ट से अपने पहले बनाए और पढ़े गए प्रोसेस तक, कुछ ही मिनटों में।

यह पेज आपके एनवायरनमेंट पर त्वरित शुरुआत के लिए Human Plugin को एक अस्थायी PostgreSQL कंटेनर के साथ चलाता है। इसे डिप्लॉय करने के लिए देखें [Docker Compose](/hi/human-plugin/self-hosting/docker-compose) या [Kubernetes](/hi/human-plugin/self-hosting/kubernetes)।

## पूर्वापेक्षाएँ

- Docker 24 या बाद का, `linux/amd64` या `linux/arm64` पर (macOS पर Docker Desktop काम करता है)।
- Unico से registry क्रेडेंशियल और access key। देखें [पूर्वापेक्षाएँ और एक्सेस](/hi/human-plugin/get-started/prerequisites)।

## 1. इमेज प्राप्त करें

अपने username और token से Unico की registry में लॉग इन करें, प्रति होस्ट एक बार:

```bash
echo "<token>" | docker login pkg.unico.run -u <username> --password-stdin
```

```bash
docker pull pkg.unico.run/human-plugin-api:latest
```

## 2. PostgreSQL और 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
```

शेल में अपनी access key सेट करें, फिर Human Plugin शुरू करें:

```bash
export HUMAN_API_ACCESS_KEY='<your 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` केवल इस लोकल डेटाबेस के लिए है। किसी भी अन्य डेटाबेस के लिए डिफ़ॉल्ट, `require`, रखें। देखें [कॉन्फ़िगरेशन](/hi/human-plugin/self-hosting/configuration)।

जाँचें कि Human Plugin तैयार है:

```bash
curl --fail http://127.0.0.1:8080/health/ready
```

आपको `{"status":"ok"}` दिखना चाहिए। यदि कमांड विफल हो, तो `docker logs human-plugin` कारण बताता है।

<a id="3-create-a-process"></a>

## 3. एक प्रोसेस बनाएँ

किसी एक [flow](/hi/human-plugin/api-reference/create-process#flows) को चुनें। `clientId`, `correlationId` और `credential` हर flow में एक जैसे हैं।

### humantoken (व्यक्ति कैप्चर करता है)

व्यक्ति कैप्चर journey में सेल्फ़ी लेता है। उत्तर में उसका `link` होता है।

```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": "<document number>" },
    "callbackUri": "https://example.com/callback"
  }'
```

```json
{
  "id": "b063041c-7529-4e70-a2b4-c71c00f19801",
  "state": "PROCESS_STATE_CREATED",
  "token": "<SDK token>",
  "link": "https://…"
}
```

`link` को फ़ोन पर खोलें और सेल्फ़ी लें। `token` और `link` केवल यहीं लौटाए जाते हैं: Human Plugin इन्हें स्टोर नहीं करता।

### api+humantoken (आप सेल्फ़ी भेजते हैं)

आपके बैक-एंड के पास पहले से सेल्फ़ी है और वह उसे `imageBase64` में भेजता है। उत्तर अंतिम होता है, Human Token और इंटेलिजेंस के साथ।

```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": "<document number>" },
    "imageBase64": "<base64 selfie>"
  }'
```

```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` प्रोसेस के लिए Human Plugin का अपना id है। इसे सँभालकर रखें: बाद में प्रोसेस पढ़ने का यही एकमात्र तरीका है।
- `correlationId` आपका संदर्भ है और अद्वितीय होना चाहिए। इसे दोबारा उपयोग करने पर `409 CORRELATION_ID_ALREADY_USED` लौटता है।
- `credential` व्यक्ति का दस्तावेज़ है। जब कोई न हो तो `null` भेजें। उपयोग किए जा सकने वाले प्रकार [एट्रिब्यूट कैटलॉग](/hi/human-plugin/additional-resources/attribute-catalog) में हैं।
- `data.humanToken` बताता है कि व्यक्ति कौन है, और `data.ndocs` व्यक्ति का इंटेलिजेंस है: उसने आपके साथ क्या किया है। देखें [इंटेलिजेंस](/hi/human-plugin/get-started/intelligence)।
- Journey के साथ, पूरा हुए प्रोसेस में `data.liveness` भी होता है: `live` जब कैप्चर किसी जीवित व्यक्ति से आया हो, `not_live` जब नहीं। देखें [`data` में नतीजा](/hi/human-plugin/api-reference/create-process#result)।

## 4. इसे वापस पढ़ें

id को अपने उत्तर वाले id से बदलें:

```bash
curl -s http://127.0.0.1:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801
```

Journey तब तक `PROCESS_STATE_CREATED` रहती है जब तक व्यक्ति कैप्चर पूरा नहीं करता। उसके बाद फिर पढ़ें: उत्तर `PROCESS_STATE_FINISHED` हो जाता है, जिसमें `data.humanToken`, `data.liveness` और `data.ndocs` होते हैं। नतीजे पर भरोसा करने से पहले जाँचें कि `data.liveness.value` `live` है।

## 5. सफ़ाई

```bash
docker rm -f human-plugin human-plugin-db && docker network rm human-plugin
```

## आगे

- [Flows](/hi/human-plugin/api-reference/create-process#flows): कौन-सा flow उपयोग करें और हर एक को क्या चाहिए।
- [प्रोसेस बनाएँ](/hi/human-plugin/api-reference/create-process): हर फ़ील्ड और नियम।
- [अपना बैकएंड इंटीग्रेट करें](/hi/human-plugin/integrations/backend): क्या स्टोर करें और विफलताओं को कैसे सँभालें।
- [Human Token Journey](/hi/human-plugin/integrations/human-token-journey): कैप्चर journey।
- [Web](/hi/human-plugin/integrations/web), [Android](/hi/human-plugin/integrations/android), [iOS](/hi/human-plugin/integrations/ios), [Ionic](/hi/human-plugin/integrations/ionic), [React Native](/hi/human-plugin/integrations/react-native) और [Flutter](/hi/human-plugin/integrations/flutter) के लिए कैप्चर गाइड: कैप्चर का फ्रंट-एंड पक्ष।
- [अपने इन्फ्रास्ट्रक्चर में Human Plugin चलाएँ](/hi/human-plugin/self-hosting/overview)