Tích hợp có contract, trạng thái và bằng chứng
Bắt đầu từ nghiệp vụ, đọc OpenAPI, kiểm schema và diễn tập lỗi trước khi yêu cầu sandbox.
Chọn điểm bắt đầu
Bắt đầu tích hợp
Chạy luồng nhận gói → theo dõi job → đăng ký → xác minh bằng dữ liệu tổng hợp.
Xem chi tiếtOpenAPI và Swagger Tham chiếu
Contract đề xuất được render từ cùng một spec cục bộ; không có Try-It mạng hoặc credential thật.
Xem chi tiếtHành trình tích hợp xuyên suốt
Nối trạng thái kỹ thuật với quyết định nghiệp vụ, thay vì chỉ liệt kê endpoint.
Xem chi tiếtAPI Explorer — mô phỏng cục bộ
Thử yêu cầu/phản hồi và tình huống lỗi bằng dữ liệu tổng hợp; không kết nối backend.
Xem chi tiếtTích hợp Thiết bị/Edge
Hợp đồng lệnh thiết bị phải giữ commandId, SheetID, hạn xử lý và ACK cùng khả năng khôi phục.
Xem chi tiếtNAPAS QR và Trusted Billing
Thiết kế tích hợp tách xác nhận thanh toán, đối soát và phát hành hóa đơn.
Xem chi tiếtAPI catalog theo domain
| Domain | HTTP | Operation / đường dẫn | Scope | Kết quả tổng hợp |
|---|---|---|---|---|
| Intake | POST | Tiếp nhận gói hồ sơ/v1/ingest-packages | ingest:write | 202 |
| Records | POST | Đăng ký và tuyên bố/v1/records/declarations | records:declare | 202 |
| Records | PATCH | Cập nhật metadata có kiểm soát/v1/records/{recordId}/metadata | records:metadata | 202 |
| Jobs | GET | Job xử lý và trạng thái/v1/jobs/{jobId} | jobs:read | 200 |
| Access | POST | Tra cứu hồ sơ/v1/records/search | records:read | 200 |
| Access | POST | Yêu cầu truy cập/v1/access-requests | access:request | 202 |
| Preservation | POST | Gói bảo quản/v1/preservation-packages | preservation:write | 202 |
| Acceptance | POST | Bàn giao và nghiệm thu/v1/deliveries/{deliveryId}/acceptance | delivery:accept | 202 |
| Evidence | POST | Xác minh bằng chứng/v1/evidence/verification | evidence:verify | 200 |
| Device/Edge | POST | Quyết định phân luồng Flow R/v1/device-commands | devices:command | 202 |
| Billing | POST | Yêu cầu thanh toán/v1/payment-requests | billing:write | 202 |
| Billing | GET | Trạng thái thanh toán/v1/payment-requests/{paymentRequestId} | billing:read | 200 |
| Billing | POST | Yêu cầu hóa đơn/v1/invoice-requests | billing:write | 202 |
| Billing | GET | Trạng thái hóa đơn/v1/invoice-requests/{invoiceRequestId} | billing:read | 200 |
Học theo tác vụ, đọc theo contract
Playground dịch vụ — theo tác vụ
Thử một hành trình hồ sơ bằng form, yêu cầu/phản hồi và dòng thời gian. Dùng dữ liệu tổng hợp trong mô phỏng ngoại tuyến hoặc HTTP mock cục bộ.
Xem chi tiếtTích hợp LTANS và bằng chứng bảo quản
Điểm nối Records–provider: kiểm tra hợp lệ, profile, biên nhận, trạng thái và xuất. Contract trang web là thiết kế đề xuất, không phải API LTANS Mobile-ID.
Xem chi tiếtTrung tâm profile bảo quản
Chọn cấu hình bảo quản theo loại hồ sơ, người sử dụng và bằng chứng cần duy trì. Các profile minh họa chưa được phê duyệt cung cấp.
Xem chi tiếtBàn giao và kiểm chứng gói mẫu
Kiểm hash của gói tổng hợp trước bàn giao; phân biệt toàn vẹn byte với xác thực, chữ ký và giá trị pháp lý.
Xem chi tiếtẢnh cuối gắn với quyết định nghiệp vụ
Ba môi trường, ba cách đánh giá
Tham chiếu: contract thiết kế được bàn giao, chưa phát hành. Simulation: Explorer chạy trong trình duyệt với dữ liệu tổng hợp, không gọi mạng. Sandbox: chỉ thử khi Mobile-ID cấp endpoint, credential, scope và dữ liệu được phép. Không có backend hoặc môi trường môi trường vận hành trong gói ngoại tuyến.
Kết quả tích hợp cần kiểm chứng
HTTP 202 chỉ nhận yêu cầu, không xác nhận hồ sơ đã đăng ký; ACK lệnh không chứng minh giấy đã đến khay; thanh toán confirmed không có nghĩa hóa đơn issued. Theo dõi ID/correlation, trạng thái đích, manifest/phiên bản và bằng chứng đối soát.
Nghiệp vụ tiếp theo
Hai hành trình, một vòng đời hồ sơ
Kết nối hồ sơ giấy và hồ sơ sinh ra ở dạng số bằng định danh, chính sách và bằng chứng xuyên suốt.
Xem chi tiếtBắt đầu tích hợp
Chạy luồng nhận gói → theo dõi job → đăng ký → xác minh bằng dữ liệu tổng hợp.
Xem chi tiếtToàn vẹn, nguồn gốc và bằng chứng
Mỗi loại bằng chứng trả lời một câu hỏi; hash, timestamp và phê duyệt không thay thế nhau.
Xem chi tiếtBắt đầu bằng một phạm vi kiểm tra được.
Chốt loại hồ sơ, tiêu chí chất lượng, quyền và bộ bằng chứng trước khi mở rộng.
Đăng ký khảo sát