---
title: Ikhtisar API
description: Endpoint Human Plugin, hubungan di antaranya, aturan respons umum, dan hal yang tidak disediakan API.
canonical: https://developer.unico.io/id/human-plugin/api-reference/overview
locale: id
generated_by: markdown-export
---

# Ikhtisar API

Tiga endpoint proses dan dua probe kesehatan.

Human Plugin dilayani melalui HTTP biasa pada port yang Anda konfigurasikan (default `8080`). URL dasarnya adalah tempat Anda mengekspos container di dalam jaringan Anda, misalnya `http://human-plugin.internal:8080`.

| Method | Path | Tujuan |
| --- | --- | --- |
| `POST` | `/v1/processes` | [Buat proses](/id/human-plugin/api-reference/create-process), dengan salah satu [alur](/id/human-plugin/api-reference/create-process#flows) |
| `GET` | `/v1/processes/{id}` | [Ambil proses](/id/human-plugin/api-reference/get-process) |
| `GET` | `/v1/processes/{id}/selfie` | [Ambil selfie](/id/human-plugin/api-reference/get-selfie) |
| `GET` | `/health/live` | Liveness. Lihat [Kesehatan dan pemantauan](/id/human-plugin/self-hosting/health-and-monitoring) |
| `GET` | `/health/ready` | Kesiapan (ping database) |

Tidak ada endpoint untuk menampilkan daftar, menghapus, atau mencari proses, dan tidak ada penerima webhook.

## Aturan yang berlaku untuk setiap panggilan

- **Tidak ada header autentikasi.** Human Plugin tidak memvalidasi pemanggil. Batasi akses jaringan sebagai gantinya: lihat [Jaringan dan keamanan](/id/human-plugin/self-hosting/networking-and-security).
- **Hanya JSON**, dengan nama field camelCase.
- **Respons bersifat `Cache-Control: no-store`.**
- **Error** menggunakan satu envelope, `{"message": "INVALID_REQUEST", "details": []}`. Lihat [Error dan percobaan ulang](/id/human-plugin/api-reference/errors-and-retries).
- **`id` adalah id proses Human Plugin.** Simpan dari respons pembuatan: dengan id itulah Anda membaca proses di kemudian hari.

## Urutan umum

```mermaid
sequenceDiagram
  participant B as Your back-end
  participant H as Human Plugin
  B->>H: POST /v1/processes
  H-->>B: 201 + id, state, data
  B->>H: GET /v1/processes/{id}
  H-->>B: 200 + id, state, data (humanToken, ndocs)
```

Selanjutnya: [Buat proses](/id/human-plugin/api-reference/create-process).