给平台用户绑定三方应用账号
接口描述:
当三方平台内的账号与认证平台内账号不同时,可通过该接口给指定的平台用户绑定应用内的账号
接口地址:
请求方式:
- POST
请求头:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
X-App-Id | 客户端 clientId | header | true | string |
请求参数:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
accessToken | 接口访问凭证 | query | true | string | |
userId | 统一身份认证平台用户Id | body | true | long | |
thirdUserId | 要绑定的三方用户Id | body | true | long | |
thirdAccount | 要绑定的三方账号 | body | true | string | |
thirdUserName | 要绑定的三方用户名称 | body | true | string |
响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ApiRestResponse«String» |
其他状态码参见:全局状态码
响应示例:
正确时返回:
{
"code": 200,
"status": "success",
"message": "应用三方用户账号绑定成功!",
}
错误时返回:
{
"code": 500,
"data": {},
"message": "成功或异常消息",
"status": "fail"
}
响应参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | 成功或异常编码 | integer(int32) | integer(int32) |
data | 成功或异常数据 | array | AppVO |
message | 成功或异常消息 | string | |
status | 旧接口成功、失败或异常辅助判断标记:success、fail、error,可用值:success,fail,error | string |
调用示例:
NodeJs - Axios:
var axios = require('axios');
var data = '{\r\n\t"clientId": "",\r\n\t"thirdAccount": "",\r\n\t"thirdUserId": 0,\r\n\t"thirdUserName": "",\r\n\t"userId": 0\r\n}';
var config = {
method: 'post',
url: 'https://api_server_url/app/account?accessToken=AT-3-ewOumlQeTN7TmVufJxq-Ph1fNVnqUTeW',
headers: {
'X-App-Id': '1',
'Content-Type': 'text/plain'
},
data : data
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});
Java - OkHttp 示例:
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "{\r\n\t\"clientId\": \"\",\r\n\t\"thirdAccount\": \"\",\r\n\t\"thirdUserId\": 0,\r\n\t\"thirdUserName\": \"\",\r\n\t\"userId\": 0\r\n}");
Request request = new Request.Builder()
.url("https://api_server_url/app/account?accessToken=AT-3-ewOumlQeTN7TmVufJxq-Ph1fNVnqUTeW")
.method("POST", body)
.addHeader("X-App-Id", "1")
.addHeader("Content-Type", "text/plain")
.build();
Response response = client.newCall(request).execute();
作者:杭州天音 创建时间:2022-10-24 11:40
最后编辑:杭州天音 更新时间:2025-08-22 15:44
最后编辑:杭州天音 更新时间:2025-08-22 15:44