跳转到主要内容
GET
列出文件证明
列出文件当前的证明(已被替换和已删除的文件不包含在内)。 错误使用带有稳定 code 的 application/problem+json。完整目录:实体状态与错误码。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

用于身份验证的 Bearer 访问令牌。该令牌可从获取访问令牌或刷新访问令牌endpoint 获取。系统将据此识别您的商户账户和执行操作的用户。

示例:

"Bearer <your_access_token>"

X-Correlation-ID
string

跟踪标识符(UUID)。会在响应中原样返回;如未提供,则由 Localpayment 生成。

示例:

"0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10"

路径参数

docId
string<uuid>
必填

文档的 documentId。

示例:

"e0ea9515-442e-4bc5-bc82-b8d278255c37"

响应

OK。

id
string
示例:

"2c4c2f74-7179-4113-83fb-f11dbce9e07d"

documentId
string<uuid>
示例:

"2e16d844-4fa9-4295-9a21-83ec32ef241a"

proofType
enum<string>
可用选项:
FRONT,
BACK,
SELFIE,
DOCUMENT,
OTHER
示例:

"FRONT"

fileName
string
示例:

"id_front.jpg"

mimeType
string
示例:

"image/jpeg"

sizeBytes
integer
示例:

102400

verificationStatus
enum<string>
可用选项:
PENDING,
IN_REVIEW,
APPROVED,
REJECTED
示例:

"PENDING"

verifiedBy
string | null
verifiedAt
string<date-time> | null
verificationReason
string | null
uploadedBy
string
示例:

"12345"

uploadedAt
string<date-time>
示例:

"2024-01-15T17:03:13Z"

status
enum<string>

证明生命周期:CURRENT(有效)、SUPERSEDED(已被相同 proofType 的新上传证明替换)或 DELETED。与 verificationStatus 无关。

可用选项:
CURRENT,
SUPERSEDED,
DELETED
示例:

"CURRENT"

supersededAt
string<date-time> | null
supersededBy
string | null
replacedByProofId
string<uuid> | null
deletedAt
string<date-time> | null
deletedBy
string | null
inVerification
boolean
示例:

false

最后修改于 2026年11月10日