VALID
Các phép kiểm tra theo ngữ cảnh được chọn đủ điều kiện kết luận hợp lệ.
MOBILE-ID · TRUSTED LTANS
API kiểm chứng
Yêu cầu đánh giá theo ngữ cảnh; theo dõi tác vụ và đọc báo cáo VALID, INVALID hoặc INDETERMINATE.
Đọc báo cáo theo ngữ cảnh
INVALID
Một hoặc nhiều phép kiểm tra cho kết quả không hợp lệ; báo cáo nêu lý do.
INDETERMINATE
Chưa đủ dữ liệu hoặc căn cứ để kết luận; không tự đổi thành hợp lệ.
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}/verification
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ụ kiểm chứng |
| Quyền ứng dụng | verification:write |
| HTTP | 202 |
| Xử lý lời gọi | Tác vụ bất đồng bộ: xem schema Job và trạng thái tài nguyên kết quả. |
| Sự kiện | VerificationRequested |
Chọn ngữ cảnh tin cậy được cấp và bổ sung dữ liệu kiểm chứng.
curl --fail-with-body --request POST \
"${BASE_URL%/}/v1/archives/${ARCHIVE_ID}/verification" \
--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}"{
"evidenceVersion": 1,
"trustContextId": "trust-test-001",
"dataReference": "https://storage.example.invalid/test/object-001"
}{
"jobId": "job-verification-001",
"state": "QUEUED",
"resourceId": "ver-test-001",
"correlationId": "corr-test-001",
"pollAfterSeconds": 2
}{
"type": "object",
"properties": {
"evidenceVersion": {
"type": "integer",
"minimum": 1
},
"trustContextId": {
"type": "string"
},
"dataReference": {
"type": "string",
"format": "uri"
}
},
"required": [
"evidenceVersion",
"trustContextId",
"dataReference"
],
"additionalProperties": false,
"examples": [
{
"evidenceVersion": 1,
"trustContextId": "trust-test-001",
"dataReference": "https://storage.example.invalid/test/object-001"
}
]
}{
"type": "https://example.invalid/problems/trust-context-unavailable",
"title": "Trust Context Unavailable",
"code": "TRUST_CONTEXT_UNAVAILABLE",
"detail": "The requested trust context is unavailable.",
"correlationId": "corr-test-001",
"requestId": "req-test-001",
"retryable": false,
"service": "Verification Service",
"timestamp": "2026-10-15T05:00:01Z",
"errors": [],
"status": 422,
"instance": "urn:ltans:request:req-test-001"
}GET/v1/verifications/{verificationId}
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ụ kiểm chứng |
| Quyền ứng dụng | verification: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ộ |
Chọn ngữ cảnh tin cậy được cấp và bổ sung dữ liệu kiểm chứng.
curl --fail-with-body --request GET \
"${BASE_URL%/}/v1/verifications/${VERIFICATION_ID}" \
--header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "X-Correlation-ID: ${CORRELATION_ID}"{
"verificationId": "ver-test-001",
"archiveId": "arc-test-001",
"outcome": "INDETERMINATE",
"evaluatedAt": "2026-10-15T05:00:00Z",
"trustContextId": "trust-test-001",
"policyId": "policy-test-v1",
"policyVersion": "1",
"toolVersion": "target-validator-1",
"evidenceVersion": 1,
"reasonCodes": [
"TEST_TRUST_MATERIAL_NOT_SUPPLIED"
],
"steps": [
{
"check": "timestamp-path",
"outcome": "INDETERMINATE",
"reasonCode": "TEST_TRUST_MATERIAL_NOT_SUPPLIED",
"detail": "Synthetic response: no trusted TSA token is bundled."
}
]
}{
"type": "object",
"properties": {
"verificationId": {
"type": "string"
},
"archiveId": {
"type": "string"
},
"outcome": {
"type": "string",
"enum": [
"VALID",
"INVALID",
"INDETERMINATE"
]
},
"evaluatedAt": {
"type": "string",
"format": "date-time"
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"check": {
"type": "string"
},
"outcome": {
"type": "string",
"enum": [
"VALID",
"INVALID",
"INDETERMINATE",
"NOT_APPLICABLE"
]
},
"detail": {
"type": "string"
},
"reasonCode": {
"type": "string"
}
},
"required": [
"check",
"outcome",
"reasonCode"
],
"additionalProperties": false
},
"minItems": 1
},
"trustContextId": {
"type": "string"
},
"policyId": {
"type": "string"
},
"policyVersion": {
"type": "string"
},
"toolVersion": {
"type": "string"
},
"evidenceVersion": {
"type": "integer",
"minimum": 1
},
"reasonCodes": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
}
},
"required": [
"verificationId",
"archiveId",
"outcome",
"steps",
"evaluatedAt",
"trustContextId",
"policyId",
"policyVersion",
"toolVersion",
"evidenceVersion",
"reasonCodes"
],
"additionalProperties": false,
"examples": [
{
"verificationId": "ver-test-001",
"archiveId": "arc-test-001",
"outcome": "INDETERMINATE",
"evaluatedAt": "2026-10-15T05:00:00Z",
"trustContextId": "trust-test-001",
"policyId": "policy-test-v1",
"policyVersion": "1",
"toolVersion": "target-validator-1",
"evidenceVersion": 1,
"reasonCodes": [
"TEST_TRUST_MATERIAL_NOT_SUPPLIED"
],
"steps": [
{
"check": "timestamp-path",
"outcome": "INDETERMINATE",
"reasonCode": "TEST_TRUST_MATERIAL_NOT_SUPPLIED",
"detail": "Synthetic response: no trusted TSA token is bundled."
}
]
}
]
}{
"type": "https://example.invalid/problems/trust-context-unavailable",
"title": "Trust Context Unavailable",
"code": "TRUST_CONTEXT_UNAVAILABLE",
"detail": "The requested trust context is unavailable.",
"correlationId": "corr-test-001",
"requestId": "req-test-001",
"retryable": false,
"service": "Verification Service",
"timestamp": "2026-10-15T05:00:01Z",
"errors": [],
"status": 422,
"instance": "urn:ltans:request:req-test-001"
}