给平台用户绑定三方应用账号

接口描述:

当三方平台内的账号与认证平台内账号不同时,可通过该接口给指定的平台用户绑定应用内的账号

接口地址:

请求方式:

  • 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