POST `/verification/verify`

提交身份核验请求，可指定核验方法（如自动、NFC、人工审核）和确认信息。核验通过后更新认证状态和年龄分组

验证服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`verification_id`	`query`	`string`	是				认证ID

请求体

Schema： service-verification/internal/handler/dto.SubmitVerificationRequest

字段	类型	必填	示例	约束	描述
`method`	`verification.VerificationMethod`	是
`confirmed_id_number`	`string`	否
`confirmed_name`	`string`	否

响应

状态	描述	Schema
200	核验结果，包含认证状态、方法、年龄分组和过期时间	`dto.DataResponse-service-verification/internal/handler/dto/VerificationStatusResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未认证或令牌无效	`dto.SimpleResponse`
500	服务内部错误	`dto.SimpleResponse`

引用的 Schema

dto.DataResponse-service-verification/internal/handler/dto/VerificationStatusResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-verification/internal/handler/dto.VerificationStatusResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-verification/internal/handler/dto.VerificationStatusResponse

字段	类型	必填	示例	约束	描述
`age_group`	`string`	否
`expires_at`	`string`	否
`max_retries`	`integer`	否
`method`	`string`	否
`provider`	`string`	否
`retry_count`	`integer`	否
`status`	`string`	否
`verification_id`	`string`	否
`verified_at`	`string`	否

verification.VerificationMethod

string

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓