1.2.2. 客户端查询请求¶
请求方式¶
GET
请求头部¶
- Authorization:
认证头部(RFC 9110#field.authorization),Bearer认证字符串(RFC 6750#section-2.1),值为您用于维护客户端信息时所使用的访问令牌。
请求路径¶
/register/{客户端标识}
响应代码¶
- 200 OK:
查询成功。
响应格式¶
application/json
响应数据¶
名称 |
类型 |
约束 |
描述 |
---|---|---|---|
|
URL |
条件 |
授权码授予方案时必选,当用户完成授权后回调到您客户端程序的地址。 |
|
字符串 |
可选 |
访问令牌请求地址时的客户端程序认证方式。 |
|
字符串列表 |
可选 |
客户端程序所选用的授予方案。 |
|
字符串 |
可选 |
授权码响应类型。 |
|
字符串 |
可选 |
您客户端程序的名称,用于以文本方式直接显示在用户授权界面。 |
|
URL |
可选 |
您客户端程序的信息页面地址,用于以链接方式显示在用户授权界面。 |
|
URL |
可选 |
您客户端程序的品牌标识地址,用于以图片方式直接显示在用户授权界面。 |
|
字符串 |
可选 |
您客户端程序所需要的权限列表。 |
|
字符串列表 |
可选 |
您的联系方式,用于以文本方式直接显示在用户授权界面。 |
|
URL |
可选 |
您客户端程序的服务条款地址,用于以链接方式显示在用户授权界面。 |
|
URL |
可选 |
您客户端程序的隐私政策地址,用于以链接方式显示在用户授权界面。 |
|
字符串 |
可选 |
您客户端程序的软件标识,一个在我们平台全局惟一的字符串,我们将按照软件标识响应最终用户标识。
对于同一个最终用户:
在相同软件标识的客户端程序中,查询到的用户标识值固定不变;
在不同软件标识的客户端程序中,查询到的用户标识值一定不同。
|
|
字符串列表 |
可选 |
您客户端程序的软件版本标识,仅用于内部数据处理使用。 |
|
布尔值 |
可选 |
您客户端程序是否仅接受预推送授权请求。 |
名称 |
类型 |
约束 |
描述 |
---|---|---|---|
|
字符串 |
必选 |
您客户端程序的客户端标识。 |
|
字符串 |
必选 |
您客户端程序的客户端秘密密钥。 |
|
整数 |
必选 |
您客户端标识的签发时间,值为北京时间1970年1月1日上午8点整到签发时间所相差的秒数(不计算闰秒)。 |
|
整数 |
必选 |
您客户端的过期时间,值为0时代表永不过期,否则值为北京时间1970年1月1日上午8点整到过期时间所相差的秒数(不计算闰秒)。 |
|
URL |
必选 |
您客户端的完整地址。 |
|
字符串 |
必选 |
您用于维护客户端信息时所使用的访问令牌。 |
交互示例¶
备注
为方便阅读,仅展示关键信息字段,并对数据进行了仅用于显示目的格式化调整。
请求示例
GET /register/5dcc3947-6d75-4fe2-aded-a0bc7faa1edf HTTP/1.1
Host: oauth2.api.neusoft.edu.cn
Authorization: Bearer Jj-zvlpOsxVNWukWBoLnPmIWu_gS0dEcUuu_eE9HzYbTKSSYLhTlrjlJvXmFaTSx
响应示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"client_id": "5dcc3947-6d75-4fe2-aded-a0bc7faa1edf",
"client_secret": "kGNrq_rOSLKTgtK_zTgMEJkcGFu96OL72b92FgJwwzm6i1zpOZ25UhPjexY8fi-v",
"client_id_issued_at": 1691519985,
"client_secret_expires_at": 1723055986,
"redirect_uris": [
"https://client.example.net/oauth2/callback"
],
"token_endpoint_auth_method": "client_secret_basic",
"grant_types": [
"authorization_code",
"refresh_token"
],
"response_types": [
"code"
],
"client_name": "示例客户端",
"software_id": "https://client.example.net",
"registration_access_token": "Jj-zvlpOsxVNWukWBoLnPmIWu_gS0dEcUuu_eE9HzYbTKSSYLhTlrjlJvXmFaTSx",
"registration_client_uri": "https://oauth2.api.neusoft.edu.cn/register/5dcc3947-6d75-4fe2-aded-a0bc7faa1edf"
}