A AuthMS API Wiki API Reference iam.tianv.com →

GET /admin/verifications/guardians

管理员根据监护人ID或未成年用户ID查询监护关系列表,至少需提供一个查询参数

未成年人保护 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
guardian_user_id query string No 监护人用户ID
minor_user_id query string No 未成年用户ID

Responses

StatusDescriptionSchema
200监护关系列表dto.ListResponse-gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto_GuardianRelationshipResponse
400请求参数错误dto.SimpleResponse
401未认证或令牌无效dto.SimpleResponse
403权限不足dto.SimpleResponse
404监护关系不存在dto.SimpleResponse
500服务内部错误dto.SimpleResponse

Referenced Schemas

dto.ListResponse-gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto_GuardianRelationshipResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
items array of

See gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto.GuardianRelationshipResponse

No 统一使用 items
message string No
pagination object No 分页信息(嵌套对象)
timestamp string No
total integer No 总条数(平铺,便于直接读取)

dto.PageInfo

FieldTypeRequiredExampleConstraintsDescription
has_next boolean No HasNext indicates whether there is a next page
has_prev boolean No HasPrev indicates whether there is a previous page
page integer No Page is the current page number (1-based)
page_size integer No PageSize is the number of items per page
total integer No Total is the total number of items across all pages
total_pages integer No TotalPages is the total number of pages

dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No

gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto.GuardianRelationshipResponse

FieldTypeRequiredExampleConstraintsDescription
consent_at string No
consent_given boolean No
consent_scope string No
created_at string No
guardian_user_id string No
id string No
minor_user_id string No
relation_type string No
verified boolean No
verified_at string No