Mobile-ID · Bảo quản bằng chứng số dài hạn
Khách hàng và đối tácDemo quy trìnhLiên hệ
Trusted LTANS
Đăng ký thử
MOBILE-ID · TRUSTED LTANS

API chuyển giao

Khởi tạo chuyển giao, truy vấn kết quả và xác nhận đúng transfer; xuất xong không tự đổi trách nhiệm hoặc xóa nguồn.

Tra thuật ngữ Việt–Anh

Gói chuyển giao có thể kiểm tra

01

Bản kê

Liệt kê byte dữ liệu, bằng chứng và ngữ cảnh được xuất.

02

Bên nhận kiểm chứng

Đối soát thành phần, băm và khả năng kiểm chứng độc lập.

03

Biên nhận

Ghi nhận điều kiện và điểm chuyển trách nhiệm.

openapi.yamlopenapi.jsonasyncapi.yamlpostman-target.json

MÔ PHỎNG CỤC BỘ · Hợp đồng mục tiêu · Không gửi yêu cầu mạng

POST/v1/archives/{archiveId}/transfers
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
JobTransferRequest Lỗi và khắc phụcTransferStarted
Thuộc tínhGiá trị
Chủ sở hữu kỹ thuậtDịch vụ lưu trữ
Quyền ứng dụngtransfers:write
HTTP202
Xử lý lời gọiTác vụ bất đồng bộ: xem schema Job và trạng thái tài nguyên kết quả.
Sự kiệnTransferStarted

Giữ nguồn đến khi bên nhận kiểm chứng và xác nhận.

cURL
curl --fail-with-body --request POST \
  "${BASE_URL%/}/v1/archives/${ARCHIVE_ID}/transfers" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}" \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --header "Content-Type: application/json" \
  --data-binary "@${REQUEST_FILE}"
Yêu cầu JSON
{
  "exportId": "exp-test-001",
  "destinationProfileId": "destination-test-001",
  "approvalId": "approval-test-002"
}
Phản hồi mục tiêu
{
  "jobId": "job-transfer-001",
  "state": "QUEUED",
  "resourceId": "trf-test-001",
  "correlationId": "corr-test-001",
  "pollAfterSeconds": 2
}
GET/v1/transfers/{transferId}
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
TransferResult Lỗi và khắc phục
Thuộc tínhGiá trị
Chủ sở hữu kỹ thuậtDịch vụ lưu trữ
Quyền ứng dụngtransfers:read
HTTP200
Xử lý lời gọiXác thực/quyền → xử lý HTTP; đây không phải enum trạng thái tài nguyên.
Sự kiệnNhật ký hoặc sự kiện nội bộ

Giữ nguồn đến khi bên nhận kiểm chứng và xác nhận.

cURL
curl --fail-with-body --request GET \
  "${BASE_URL%/}/v1/transfers/${TRANSFER_ID}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}"
Phản hồi mục tiêu
{
  "transferId": "trf-test-001",
  "archiveId": "arc-test-001",
  "exportId": "exp-test-001",
  "recipientId": "recipient-test-001",
  "state": "AWAITING_ACKNOWLEDGEMENT",
  "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example",
  "jobId": "job-transfer-001",
  "packageDigest": {
    "algorithm": "SHA-256",
    "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1"
  }
}
POST/v1/transfers/{transferId}/acknowledgements
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft

Bên nhận xác nhận đúng transferId, exportId, recipientId, digest và scope. Backend phải đối chiếu danh tính phiên với bên nhận, từ chối sai phạm vi và giữ statement có audit.

TransferResultTransferAcknowledgement Lỗi và khắc phụcTransferCompleted
Thuộc tínhGiá trị
Chủ sở hữu kỹ thuậtDịch vụ lưu trữ
Quyền ứng dụngtransfers:acknowledge
HTTP201
Xử lý lời gọiXác thực/quyền → xử lý HTTP; đây không phải enum trạng thái tài nguyên.
Sự kiệnTransferCompleted

Giữ nguồn đến khi bên nhận kiểm chứng và xác nhận.

cURL
curl --fail-with-body --request POST \
  "${BASE_URL%/}/v1/transfers/${TRANSFER_ID}/acknowledgements" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}" \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --header "Content-Type: application/json" \
  --data-binary "@${REQUEST_FILE}"
Yêu cầu JSON
{
  "transferId": "trf-test-001",
  "exportId": "exp-test-001",
  "recipientId": "recipient-test-001",
  "packageDigest": {
    "algorithm": "SHA-256",
    "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1"
  },
  "verificationReportReference": "urn:ltans:synthetic:recipient-report-001",
  "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example",
  "acceptedAt": "2026-10-15T09:00:00Z"
}
Phản hồi mục tiêu
{
  "transferId": "trf-test-001",
  "archiveId": "arc-test-001",
  "exportId": "exp-test-001",
  "recipientId": "recipient-test-001",
  "state": "ACKNOWLEDGED",
  "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example",
  "jobId": "job-transfer-001",
  "packageDigest": {
    "algorithm": "SHA-256",
    "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1"
  },
  "acknowledgementId": "ack-test-001",
  "acceptedAt": "2026-10-15T09:00:00Z"
}

Bước tiếp theo

Chuyển giao khi kết thúc nhà cung cấpXuất và chuyển giaoAPI tác vụ

Tìm trong tài liệu LTANS

Ảnh minh họa được mở rộng