API cấp quyền | Trusted Palm ID

POST /authorizations

Đánh giá quyền hành động độc lập với kết quả đối sánh.

Phiên bản: 0.4.0 (dự thảo)
Xác thực: Bearer token + mTLS (mục tiêu)
Phạm vi: Ứng dụng khách, tổ chức, mục đích và tài nguyên được cấp
Nội dung: application/json
Bằng chứng: evidenceRef

Lược đồ yêu cầu minh họa

Trường	Kiểu	Yêu cầu
`requestId`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`tenantRef`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`purpose`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`deviceRef`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`verificationRef`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`subjectRef`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`resourceRef`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`action`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.
`policyRef`	chuỗi	Bắt buộc trong mô hình dự thảo; mã tham chiếu, không là dữ liệu sinh trắc học.

Mô phỏng & mã mẫu

Mô phỏng cục bộ - không gọi mạngv0.4.0 (dự thảo)

Chọn dịch vụMôi trườngTình huống

Chưa có địa chỉ Sandbox/UAT thật được phê duyệt. Không nhập dữ liệu cá nhân hay sinh trắc học.

Yêu cầu

Phản hồi minh họa

200

{
  "requestId": "demo-request-001",
  "traceId": "demo-trace-001",
  "service": "authorizations",
  "modelStatus": "ILLUSTRATIVE_ONLY",
  "authorizationDecision": "STEP_UP_REQUIRED",
  "policyRef": "demo-policy-001",
  "reasonCode": "ADDITIONAL_FACTOR_REQUIRED",
  "evidenceRef": "demo-evidence-001"
}

Mã gọi HTTP - không phải SDK

Máy chủ example.invalid không phải điểm kết nối vận hành chính thức. Mã mẫu yêu cầu cấu hình xác thực và mTLS đã được phê duyệt.

Ngoại lệ và thử lại

HTTP	Mã mẫu	Hành vi khuyến nghị
422	`CAPTURE_QUALITY_LOW`	Thu nhận chưa đạt; hướng dẫn thử lại.
422	`PRESENTATION_REJECTED`	Không tiếp tục phiên; chuyển phương án thay thế theo chính sách.
409	`SESSION_EXPIRED`	Tạo phiên mới, không phát lại dữ liệu cũ.
403	`DEVICE_UNTRUSTED`	Từ chối phiên và chuyển đội vận hành kiểm tra thiết bị.
403	`SCOPE_NOT_ALLOWED`	Kiểm tra quyền ứng dụng khách, tổ chức và mục đích.
429	`RATE_LIMITED`	Tôn trọng Retry-After, giới hạn số lần thử lại.
503	`PROCESSING_UNAVAILABLE`	Không suy diễn thành công; dùng phương án thay thế.

Tiếp tục khám phá

Đi từ nghiệp vụ đến công nghệ, tích hợp và bằng chứng.