MOBILE-ID · TRUSTED LTANS
Phiên bản hợp đồng
Quản lý phiên bản REST, sự kiện và chính sách áp dụng; giữ khả năng đối soát khi thay đổi tích hợp.
Quy tắc tương thích và chọn phiên bản
Phiên bản website, REST, sự kiện và policy có vòng đời riêng. REST hiện là 3.0.0-draft; envelope sự kiện là 2.0. Đây là thiết kế mục tiêu, không phải URL backend đã cấp.
| Thay đổi | Cách xử lý |
|---|---|
| Thêm tài liệu/giải thích | Không đổi schema hay ý nghĩa field; kiểm tra ví dụ và route. |
| Thêm trường bắt buộc / siết enum | Breaking với client cũ; nâng phiên bản, thử consumer và kế hoạch migration. |
| Policy có hiệu lực | Giữ snapshot và phiên bản đã áp dụng cho từng hồ sơ; không lấy cấu hình mới để viết lại lịch sử. |
Chuyển từ draft 2 sang draft 3
Client cần đọc ExportResult/TransferResult/HoldResult thay ResourceResult tại các endpoint tương ứng. Acknowledgment nhận TransferAcknowledgement thay Digest. Consumer sự kiện phải hiểu resourceType/resourceId, aggregateRevision và envelope 2.0. Không coi đây là thay đổi tương thích ngược.