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 lưu trữ dài hạn

Gửi một bộ hồ sơ, đối soát biên nhận và truy vấn trạng thái; phân biệt tiếp nhận với bằng chứng sẵn sàng.

Tra thuật ngữ Việt–Anh

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
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
AcknowledgementArchiveRequest Lỗi và khắc phụcArchiveRequested
Thuộc tínhGiá trị
Chủ sở hữu kỹ thuậtDịch vụ lưu trữ
Quyền ứng dụngarchives: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ệnArchiveRequested

Đối chiếu khóa và nội dung; kiểm tra kết quả trước khi tạo yêu cầu mới.

cURL
curl --fail-with-body --request POST \
  "${BASE_URL%/}/v1/archives" \
  --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
{
  "profileId": "profile-test-01",
  "policyId": "policy-test-v1",
  "mimeType": "text/plain",
  "metadata": {
    "title": "LTANS-SYN-001 / r1",
    "sourceId": "LTANS-SYN-001",
    "sourceRevision": "r1"
  },
  "custody": "CUSTOMER_MANAGED",
  "dataReference": "https://storage.example.invalid/test/primary-record.txt",
  "digest": {
    "algorithm": "SHA-256",
    "value": "35bc4fcffc4a16c8a9db81d1a8f9042c27a1daaf51628b4c880f312178fe3085"
  },
  "archivalPeriod": {
    "endAt": "2036-10-15T00:00:00Z"
  },
  "clientReference": "LTANS-SYN-001/r1",
  "requestTime": "2026-10-15T05:00:00Z",
  "groupId": "grp-syn-001"
}
Phản hồi mục tiêu
{
  "archiveId": "arc-test-001",
  "jobId": "job-test-001",
  "policyId": "policy-test-v1",
  "policyVersion": "1",
  "receivedAt": "2026-10-15T05:00:01Z",
  "state": "ACCEPTED"
}
GET/v1/archives
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
ArchiveList 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ụngarchives: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ộ

Đối chiếu khóa và nội dung; kiểm tra kết quả trước khi tạo yêu cầu mới.

cURL
curl --fail-with-body --request GET \
  "${BASE_URL%/}/v1/archives" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}"
Phản hồi mục tiêu
{
  "items": [
    {
      "archiveId": "arc-test-001",
      "profileId": "profile-test-01",
      "policyId": "policy-test-v1",
      "custody": "CUSTOMER_MANAGED",
      "mimeType": "application/pdf",
      "metadata": {
        "title": "Synthetic record"
      },
      "state": "EVIDENCE_READY",
      "evidenceVersion": 1
    }
  ]
}
GET/v1/archives/{archiveId}
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
ArchiveObject 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ụngarchives: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ộ

Đối chiếu khóa và nội dung; kiểm tra kết quả trước khi tạo yêu cầu mới.

cURL
curl --fail-with-body --request GET \
  "${BASE_URL%/}/v1/archives/${ARCHIVE_ID}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}"
Phản hồi mục tiêu
{
  "archiveId": "arc-test-001",
  "profileId": "profile-test-01",
  "policyId": "policy-test-v1",
  "custody": "CUSTOMER_MANAGED",
  "mimeType": "application/pdf",
  "metadata": {
    "title": "Synthetic record"
  },
  "state": "EVIDENCE_READY",
  "evidenceVersion": 1
}
GET/v1/archives/{archiveId}/status
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
ArchiveObject 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ụngarchives: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ộ

Đối chiếu khóa và nội dung; kiểm tra kết quả trước khi tạo yêu cầu mới.

cURL
curl --fail-with-body --request GET \
  "${BASE_URL%/}/v1/archives/${ARCHIVE_ID}/status" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}"
Phản hồi mục tiêu
{
  "archiveId": "arc-test-001",
  "profileId": "profile-test-01",
  "policyId": "policy-test-v1",
  "custody": "CUSTOMER_MANAGED",
  "mimeType": "application/pdf",
  "metadata": {
    "title": "Synthetic record"
  },
  "state": "EVIDENCE_READY",
  "evidenceVersion": 1
}
POST/v1/archives/{archiveId}/dispositions
HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft
JobDispositionRequest Lỗi và khắc phụcDispositionRequested
Thuộc tínhGiá trị
Chủ sở hữu kỹ thuậtDịch vụ kho
Quyền ứng dụngdisposition: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ệnDispositionRequested

Đối chiếu khóa và nội dung; kiểm tra kết quả trước khi tạo yêu cầu mới.

cURL
curl --fail-with-body --request POST \
  "${BASE_URL%/}/v1/archives/${ARCHIVE_ID}/dispositions" \
  --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
{
  "scope": "PAYLOAD",
  "approvalId": "approval-test-004",
  "reason": "Synthetic expiry test"
}
Phản hồi mục tiêu
{
  "jobId": "job-disposition-001",
  "state": "QUEUED",
  "resourceId": "arc-test-001",
  "correlationId": "corr-test-001",
  "pollAfterSeconds": 2
}

Bước tiếp theo

Dịch vụ lưu trữ dài hạnTác vụ bất đồng bộMô hình quản lý dữ liệu
Archive API tham chiếu
Archive API tham chiếu · Minh họa giao diện mục tiêu.
Phóng to và xem vùng chi tiếtTải ảnh gốc

Tìm trong tài liệu LTANS

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