代理客户端三方用户登录

更新时间：2026-05-19 19:16:21

服务器端代理客户端的三方用户登录，支持AuthFlag参数

描述	值
路径	/platform/account/proxy/login
版本号	1.0.0
协议	HTTPS
请求方法	POST

请求参数：

公共请求参数见公共请求参数

请求字段	类型	必选	描述
authCode	String	是	一般是三方用户登录自有平台返回的认证Code，建议是一次性的，参考：自有账号体系登录
appKey	String	是	开放平台颁发的appKey，可以是Android/iOS/Web等，参考：App配置之查看密钥
clientUniqueKey	String	否	客户端唯一标识。长度不超过64位。如果不填，则不会返回对应的token信息，此时只会返回authCode对应三方用户在相速平台的用户标识。
authFlag	String	否	认证标识，主要用于私有化部署场景，可支持跨大洲部署时按authFlag就近认证。

返回参数：

返回字段	类型	描述
id	String	用于识别请求记录，即对应的请求ID。
code	Int	接口返回码字段，请求成功时返回200；请求失败时返回详细的错误码。
message	String	调用失败时，返回的出错信息。
data	Object	响应的结果。
accessToken	String	访问令牌，用于客户端访问服务器的凭证。
refreshToken	String	刷新令牌，在访问令牌过期后，可以用来获取新的访问令牌以及刷新令牌。用于后续的token刷新接口，暂不支持。
expireTime	Int	accessToken的有效时间，单位秒。
accessTokenCreateTime	Int	accessToken发放时间，从1970年1月1日起至今的时间转换为毫秒。
accessTokenExpireTime	Int	accessToken过期时间，从1970年1月1日起至今的时间转换为毫秒。
userId	Int	相速平台对应的用户标识，一般提供给客户端初始化信令等场景使用。

请求示例：

x-ca-key: xxxxxxxx
x-ca-timestamp: 1728634151000
x-ca-nonce: 7b25fc15b9434dd98587a077a92b7e42
x-ca-signature: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json;charset=UTF-8

{
    "id": "49a7be925e******8ba0facf7",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "authCode": "authCodeXXX***",
        "appKey": "appKeyYYY***",
        "clientUniqueKey": "appKeyYYY***",
        "authFlag": "ipc"
    }
}

成功返回示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
    "id": "49a7be925e******8ba0facf7",
    "code": 200,
    "message": "success",
    "data": {
        "accessToken": "eyJhbGciOiJI******zv6d5bN9KtehpcnmiquETlYs_NZmmEKyZq1NbM",
        "refreshToken": "eyJhbGciO******SBuLUqCjm8qXRM5Z3f663tOEMZmjKX3gULY4",
        "expireTime": 86400,
        "accessTokenCreateTime": 1779186034000,
        "accessTokenExpireTime": 1779272434000,
        "userId": 666
    }
}

请求参数：​

返回参数：​

请求示例：​

成功返回示例：​

请求参数：

返回参数：

请求示例：

成功返回示例：