Webhook trả lỗi do schema cũ; xác định phiên bản, duyệt sửa và replay có chống trùng.
Trusted Records · Tích hợp & Nhà phát triển
Quản trị tích hợp
Cấp quyền và đưa tích hợp vào môi trường vận hành theo contract, chứng thư và tiêu chí kiểm thử được duyệt.
Đầu vào và điều kiện bắt đầu
OAuth client/scopes, contract trạng thái, credential/certificate, webhook endpoint, quota và hồ sơ kiểm thử.
Quy trình và cổng kiểm soát
- 01Đăng ký client
- 02Duyệt scope / contract
- 03Thử callback / lỗi
- 04Duyệt môi trường vận hành
- 05Rotate và audit
Contract proposed không phải API available. Xoay vòng phải kiểm overlap/thu hồi; mTLS xác thực kênh nhưng không thay kiểm quyền nghiệp vụ. Webhook cần chữ ký, replay chính sách và audit.
Ngoại lệ và cách xử lý
Webhook thử lại hết ngưỡng chuyển ngoại lệ hàng đợi; replay phải giữ eventId và quyền duyệt. Credential lộ cần thu hồi/rotate và kiểm ảnh hưởng, không chép secret vào nhật ký.
Vai trò, đầu ra và trạng thái
| Trách nhiệm | Bằng chứng và trạng thái |
|---|---|
| Nhà phát triển đăng ký; org/bảo mật duyệt scopes; platform vận hành; chủ sở hữu nghiệm thu tích hợp; audit kiểm contract/phiên bản. | Contract/phiên bản/trạng thái, client phê duyệt, certificate lịch sử, thử lại/replay nhật ký và duyệt môi trường vận hành. Trạng thái: proposed → rà soát → tested → approved theo hồ sơ thực tế. |
Tình huống và tiêu chí nghiệm thu
Chỉ hoàn tất khi
Không đóng sự cố chỉ vì lần gửi sau trả HTTP thành công.
Màn hình gắn với nghiệp vụ
Điểm nối tích hợp
Hà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ế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ếtLỗi và bước xử lý tiếp
Một lỗi envelope thống nhất giúp định tuyến khôi phục mà không lộ dữ liệu nhạy cảm.
Xem chi tiếtNghiệp vụ tiếp theo
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ếtHai 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ế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