1.2.2. 客户端查询请求

请求方式

GET

请求头部

Authorization:

认证头部(RFC 9110#field.authorization),Bearer认证字符串(RFC 6750#section-2.1),值为您用于维护客户端信息时所使用的访问令牌。

请求路径

/register/{客户端标识}

响应代码

200 OK:

查询成功。

响应格式

application/json

响应数据

客户端元数据(通用)

名称

类型

约束

描述

redirect_uris

URL

条件

授权码授予方案时必选,当用户完成授权后回调到您客户端程序的地址。

token_endpoint_auth_method

字符串

可选

访问令牌请求地址时的客户端程序认证方式。

grant_types

字符串列表

可选

客户端程序所选用的授予方案。

response_types

字符串

可选

授权码响应类型。

client_name

字符串

可选

您客户端程序的名称,用于以文本方式直接显示在用户授权界面。

client_uri

URL

可选

您客户端程序的信息页面地址,用于以链接方式显示在用户授权界面。

logo_uri

URL

可选

您客户端程序的品牌标识地址,用于以图片方式直接显示在用户授权界面。

scope

字符串

可选

您客户端程序所需要的权限列表。

contacts

字符串列表

可选

您的联系方式,用于以文本方式直接显示在用户授权界面。

tos_uri

URL

可选

您客户端程序的服务条款地址,用于以链接方式显示在用户授权界面。

policy_uri

URL

可选

您客户端程序的隐私政策地址,用于以链接方式显示在用户授权界面。

software_id

字符串

可选

您客户端程序的软件标识,一个在我们平台全局惟一的字符串,我们将按照软件标识响应最终用户标识。

对于同一个最终用户:
在相同软件标识的客户端程序中,查询到的用户标识值固定不变;
在不同软件标识的客户端程序中,查询到的用户标识值一定不同。

software_version

字符串列表

可选

您客户端程序的软件版本标识,仅用于内部数据处理使用。

require_pushed_authorization_requests

布尔值

可选

您客户端程序是否仅接受预推送授权请求。

客户端元数据(扩展)

名称

类型

约束

描述

client_id

字符串

必选

您客户端程序的客户端标识。

client_secret

字符串

必选

您客户端程序的客户端秘密密钥。

client_id_issued_at

整数

必选

您客户端标识的签发时间,值为北京时间1970年1月1日上午8点整到签发时间所相差的秒数(不计算闰秒)。

client_secret_expires_at

整数

必选

您客户端的过期时间,值为0时代表永不过期,否则值为北京时间1970年1月1日上午8点整到过期时间所相差的秒数(不计算闰秒)。

registration_client_uri

URL

必选

您客户端的完整地址。

registration_access_token

字符串

必选

您用于维护客户端信息时所使用的访问令牌。

交互示例

备注

为方便阅读,仅展示关键信息字段,并对数据进行了仅用于显示目的格式化调整。

请求示例

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"
}