NHÀ PHÁT TRIỂN · CHECKID

Tạo quy trình

Tạo quy trình trong chủ thể với loại quy trình, nhà cung cấp, mục đích và bối cảnh.

HỢP ĐỒNGAPI / SDK có quản lý phiên bản
XÁC THỰCOAuth2 / môi trường
ĐẦU RAPhản hồi · mã kết quả · bằng chứng
THEO NGUỒN REST HỢP ĐỒNG

Tạo quy trình

Tạo một quy trình xác minh bên trong một chủ thể. Mỗi chủ thể có thể có nhiều quy trình; mỗi quy trình chỉ thuộc về một chủ thể.

Hợp đồng API nguồnCheckID API And Kafka Specifications · V1.2.260123
POST/v1/create/process
Bearer + OAuth2 Client Credentials3.4 · Creates quy trìnhnguồn p.14

Tạo một quy trình xác minh bên trong một chủ thể. Mỗi chủ thể có thể có nhiều quy trình; mỗi quy trình chỉ thuộc về một chủ thể.

Mở trong Trình khám phá API ↗
Trường Loại Yêu cầu Mô tả
subject_id String M Unique chủ thể định danh
provider String O Nhà cung cấp dịch vụ định danh
process_type String M Loại quy trình xác minh
claim_sources Đối tượng M/O Nguồn thuộc tính đã ký cho các luồng áp dụng
purpose String M TẠO · AMEND · ADJUST · AUTHORIZE · ĐĂNG KÝ
YÊU CẦU — DỮ LIỆU ĐÃ ẨN DANHKHÔNG CHỨA THÔNG TIN BÍ MẬT MÔI TRƯỜNG THỰC TẾ
{
  "subject_id": "<CHỦ THỂ_ID>",
  "provider": "mobile-id",
  "process_type": "LIVE_FACIAL_MATCHING_EKYC",
  "identity_document": {
    "type": "CITIZEN_CARD",
    "value": "<CITIZEN_ID_SAMPLE>"
  },
  "purpose": "CREATE",
  "external_id": "demo-process-001"
}
PHẢN HỒICẤU TRÚC DỮ LIỆU ĐÃ ĐẶC TẢ
{
  "status": 0,
  "message": "SUCCESSFULLY",
  "dtis_id": "<DTIS_TRANSACTION_ID>",
  "process_id": "<PROCESS_ID>",
  "process_status": "PENDING",
  "provider": "mobile-id"
}
Phạm vi công bốVí dụ được thay bằng giá trị giữ chỗ rõ ràng; website không gửi yêu cầu tới môi trường môi trường thật.
THAM CHIẾU API

Đặc tả thực tế: Tạo quy trình

POST · /v1/create/process

Điểm kết nối & mục đích

POST /v1/create/process. Tạo một quy trình xác minh bên trong một chủ thể; mỗi chủ thể có thể chứa nhiều quy trình.

Xác thực

Bearer . Không thay đổi cơ chế này bằng suy đoán từ tài liệu kế thừa.

Phạm vi công bố

Đối tác. Nguồn: CheckID API đặc tả V1.2.260123 §2.2.10.

Cấu trúc yêu cầu

{
  "process_type": "FACIAL_IDENTIFICATION",
  "purpose": "CREATE",
  "identity_document": {
    "type": "CITIZEN_CARD",
    "value": "<DOCUMENT_NUMBER>"
  }
}

Cấu trúc phản hồi

{
  "process_status": "PROCESSING",
  "x-process-id": "<PROCESS_ID>",
  "x-billcode-id": "<BILLCODE_ID>"
}

Lỗi / khôi phục

Ngữ nghĩa lỗi phải dùng raw đặc tả/danh mục lỗi; cơ chế thử lại/tính bất biến khi lặp/thời gian chờ chỉ được áp dụng nếu nguồn tương ứng định nghĩa.