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

GET /mfa/push/challenge/{id}

根据挑战ID查询单条Push MFA挑战的当前状态,用于登录页面轮询。参考:NIST SP 800-63B §5.1.7 (Verifier Impersonation Resistance)、OWASP ASVS V2.8。

MFA `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
id path string Yes 挑战ID

Responses

StatusDescriptionSchema
200挑战状态dto.PushChallengeStatusDetailResponse
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
404挑战未找到gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.PushChallengeStatusDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.PushChallengeStatusResponse No
message string No
timestamp string No

dto.PushChallengeStatusResponse

FieldTypeRequiredExampleConstraintsDescription
challenge_id string No chal-abc123
login_context string No login from Beijing
number_matching string No 42
resolved_at string No 2026-05-25T12:05:00Z
status string No approved

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No