/oauth/device/authorize
OAuth 2.0 设备授权端点。设备发起授权请求,获取 device_code 和 user_code,用户随后在浏览器中输入 user_code 完成授权。公开端点,无需认证。参考:RFC 8628 §3.1 (Device Authorization Grant)。
Request Body
Schema: dto.DeviceAuthorizationRequest
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | 设备授权响应(含 device_code, user_code, verification_uri, expires_in, interval) | dto.DeviceAuthorizationDetailResponse |
| 400 | invalid_client:客户端未找到或未激活。参考:RFC 8628 §3.1。 | dto.OAuthErrorResponse |
| 500 | server_error:创建设备授权失败。参考:RFC 8628 §3.1。 | dto.OAuthErrorResponse |
Referenced Schemas
dto.DeviceAuthorizationDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
data |
dto.DeviceAuthorizationResponse |
No | |||
message |
string |
No | |||
timestamp |
string |
No |
dto.DeviceAuthorizationResponse
设备码授权响应(RFC 8628 §3.2)
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
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标准错误响应
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
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 |
状态 |