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

POST /oauth/device/authorize

OAuth 2.0 设备授权端点。设备发起授权请求,获取 device_code 和 user_code,用户随后在浏览器中输入 user_code 完成授权。公开端点,无需认证。参考:RFC 8628 §3.1 (Device Authorization Grant)。

OAuth None application/json

Request Body

Schema: dto.DeviceAuthorizationRequest

FieldTypeRequiredExampleConstraintsDescription
client_id string Yes app-123
scope string No openid profile

Responses

StatusDescriptionSchema
200设备授权响应(含 device_code, user_code, verification_uri, expires_in, interval)dto.DeviceAuthorizationDetailResponse
400invalid_client:客户端未找到或未激活。参考:RFC 8628 §3.1。dto.OAuthErrorResponse
500server_error:创建设备授权失败。参考:RFC 8628 §3.1。dto.OAuthErrorResponse

Referenced Schemas

dto.DeviceAuthorizationDetailResponse

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

dto.DeviceAuthorizationResponse

设备码授权响应(RFC 8628 §3.2)

FieldTypeRequiredExampleConstraintsDescription
device_code string No 01ARZ3NDEKTSV4RRFFQ69G5FAV
expires_in integer No 600
interval integer No 5
user_code string No BDJW-DSXQ
verification_uri string No https://authms.example.com/device

dto.OAuthErrorResponse

OAuth标准错误响应

FieldTypeRequiredExampleConstraintsDescription
error string No invalid_request 错误码
error_description string No Missing required parameter 错误描述
error_uri string No https://docs.example.com/errors 错误URI
state string No state-123 状态