Chuyển tới nội dung chính

Xác thực CCCD gắn chip với Bộ Công an (C06)

POST 
/eid/verify
Gửi thử gọi API thật

Có kết luận là trừ lượt, và cần dữ liệu chip thật. Nên tạo một ứng dụng riêng để thử và thu hồi key sau khi xong. Không dán key vào máy dùng chung.

Gửi dữ liệu đọc từ chip CCCD. Bắt buộc có SOD, và có DG1, DG13 hoặc id_number để xác định số CCCD. eVerify tách chứng thư số từ SOD rồi xác thực với Bộ Công an.

Tính phí: chỉ khi Bộ Công an có kết luận. result: VALID và result: INVALID đều tính 1 lượt. Response có error (4xx, 5xx) không tính phí.

Gửi lại an toàn: nên gửi Idempotency-Key. Gửi lại cùng key và cùng nội dung trong 24 giờ sẽ nhận lại kết quả cũ kèm Idempotent-Replayed: true và không bị trừ thêm. Cùng key nhưng khác nội dung trả 409 IDEMPOTENCY_CONFLICT.

eVerify không lưu dữ liệu chip, chỉ lưu số CCCD đã che. Gọi API này từ máy chủ của bạn.

Yêu cầu​

Phản hồi​

BCA đã có kết luận (VALID hoặc INVALID) — đã trừ 1 lượt. Gửi lại cùng Idempotency-Key trả bản này với header Idempotent-Replayed: true.

Response header
    X-Request-Id

    Mã request (req_<ulid>, hoặc giá trị khách gửi ở X-Request-Id). Gửi kèm khi liên hệ hỗ trợ.

    RateLimit-Limit

    Số request tối đa mỗi phút của ứng dụng (hạn mức hiệu lực).

    RateLimit-Remaining

    Số request còn lại trong cửa sổ hiện tại.

    RateLimit-Reset

    Số giây tới khi có thêm chỗ trống.

    Idempotent-Replayed

    Có (true) khi đây là response phát lại.