Quyết định phân luồng Flow R
Thiết kế adapter để thảo luận; RECEIVED không xác nhận giấy đã đến khay.
Request schema từ OpenAPI
| Trường | Kiểu | Bắt buộc | Ràng buộc | Định nghĩa kỹ thuật |
|---|---|---|---|---|
commandId | string | Có | {"minLength": 1, "maxLength": 128} | Proposed commandId field. Synthetic identifiers must not contain personal data. |
stationId | string | Có | {"minLength": 1, "maxLength": 128} | Proposed stationId field. Synthetic identifiers must not contain personal data. |
sheetId | string | Có | {"minLength": 1, "maxLength": 128} | Proposed sheetId field. Synthetic identifiers must not contain personal data. |
dossierId | string | Có | {"minLength": 1, "maxLength": 128} | Proposed dossierId field. Synthetic identifiers must not contain personal data. |
trayId | string | Có | {"minLength": 1, "maxLength": 128} | Proposed trayId field. Synthetic identifiers must not contain personal data. |
targetSheetIndex | integer | Có | {"minimum": 1} | One-based intended position within the dossier, not capture order. |
decisionVersion | integer | Có | {"minimum": 1} | Proposed decisionVersion field. Synthetic identifiers must not contain personal data. |
deadline | string | Có | {"minLength": 1, "format": "date-time"} | Proposed deadline field. Synthetic identifiers must not contain personal data. |
Đọc operation và bước xử lý tiếp
Lỗ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ếtĐộ tin cậy, concurrency và khôi phục
Thiết kế thử lại phải theo loại tác động, không lặp mọi yêu cầu một cách mù quáng.
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ếtRanh giới contract
Thiết kế adapter để thảo luận; RECEIVED không xác nhận giấy đã đến khay.
Ngoại lệ và đối soát
Timeout cần query trạng thái; không tạo giao dịch/lệnh mới khi kết quả cũ chưa rõ. Lưu correlation, phiên bản và bằng chứng; không gửi hồ sơ hoặc credential trong nhật ký.
Ví dụ HTTP — contract đề xuất
Request
POST https://records.example.invalid/v1/device-commands HTTP/1.1
Authorization: Bearer <example-token>
X-Tenant-Id: synthetic-tenant-001
X-Project-Id: synthetic-project-001
X-Correlation-Id: synthetic-correlation-001
Idempotency-Key: synthetic-key-001
Content-Type: application/json
{
"commandId": "synthetic-command-001",
"stationId": "synthetic-station-001",
"sheetId": "synthetic-sheet-001",
"dossierId": "synthetic-dossier-001",
"trayId": "synthetic-tray-001",
"targetSheetIndex": 1,
"decisionVersion": 1,
"deadline": "2026-10-08T00:00:05Z"
}Response · 202
{
"commandId": "synthetic-command-001",
"state": "RECEIVED",
"executionConfirmed": false
}Trường bắt buộc và kiểm soát chung
| Mục | Quy tắc đề xuất |
|---|---|
| scope | devices:command |
| required | commandId, stationId, sheetId, dossierId, trayId, targetSheetIndex, decisionVersion, deadline |
| tenant / project | Token và context phải khớp; không chỉ tin header. |
| idempotency | POST/PATCH: cùng key + body trả kết quả cũ; body khác trả 409; window cần chốt. |
| error | code, message, requestId, correlationId, retryable, details; không chứa dữ liệu nhạy cảm. |
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