MOBILE-ID · TRUSTED LTANS

API bản ghi bằng chứng

Lấy bản ghi bằng chứng và đúng phiên bản để kiểm tra cấu trúc, lịch sử và liên kết dữ liệu.

openapi.yaml openapi.json asyncapi.yaml postman-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

GET/v1/archives/{archiveId}/evidence

HỢP ĐỒNG MỤC TIÊU · API 3.0.0-draft

Thuộc tính	Giá trị
Chủ sở hữu kỹ thuật	Dịch vụ bằng chứng
Quyền ứng dụng	evidence:read
HTTP	200
Xử lý lời gọi	Xác thực/quyền → xử lý HTTP; đây không phải enum trạng thái tài nguyên.
Sự kiện	Nhật ký hoặc sự kiện nội bộ

Theo dõi tác vụ cũ đến khi bằng chứng sẵn sàng.

cURL

curl --fail-with-body --request GET \
  "${BASE_URL%/}/v1/archives/${ARCHIVE_ID}/evidence" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}"

Phản hồi mục tiêu

{
  "archiveId": "arc-test-001",
  "version": 1,
  "syntax": "ASN1_ERS",
  "mediaType": "application/octet-stream",
  "downloadReference": "/v1/downloads/evidence-test-001",
  "digest": {
    "algorithm": "SHA-256",
    "value": "0000000000000000000000000000000000000000000000000000000000000000"
  },
  "policyHistory": [
    "policy-test-v1"
  ]
}

JSON Schema

{
  "type": "object",
  "properties": {
    "archiveId": {
      "type": "string"
    },
    "version": {
      "type": "integer",
      "minimum": 1
    },
    "syntax": {
      "type": "string",
      "enum": [
        "ASN1_ERS",
        "XMLERS"
      ]
    },
    "mediaType": {
      "type": "string"
    },
    "downloadReference": {
      "type": "string",
      "format": "uri-reference"
    },
    "digest": {
      "$ref": "#/components/schemas/Digest"
    },
    "policyHistory": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "archiveId",
    "version",
    "syntax",
    "downloadReference"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "archiveId": "arc-test-001",
      "version": 1,
      "syntax": "ASN1_ERS",
      "mediaType": "application/octet-stream",
      "downloadReference": "/v1/downloads/evidence-test-001",
      "digest": {
        "algorithm": "SHA-256",
        "value": "0000000000000000000000000000000000000000000000000000000000000000"
      },
      "policyHistory": [
        "policy-test-v1"
      ]
    }
  ]
}

application/problem+json

{
  "type": "https://example.invalid/problems/evidence-not-ready",
  "title": "Evidence Not Ready",
  "code": "EVIDENCE_NOT_READY",
  "detail": "The evidence version is not ready.",
  "correlationId": "corr-test-001",
  "requestId": "req-test-001",
  "retryable": false,
  "service": "Evidence Service",
  "timestamp": "2026-10-15T05:00:01Z",
  "errors": [],
  "status": 409,
  "instance": "urn:ltans:request:req-test-001"
}

GET/v1/archives/{archiveId}/evidence/{evidenceVersion}