全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
根据订单获取买家 openuid
接口地址: http://api.vv-tool.com/tool/erps/tbgetbyorder
接口介绍: 根据订单获取买家 openuid,最大查询 30 个 点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 扣账户余额
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
shop_id | String | 是 | 店铺 ID |
tid_infos | BuyerOrder | 是 | 买家订单列表 |
--tid | Number | 是 | 交易编号 |
--buyer_nick | String | 是 | 买家 nick |
vvtype | int | 是 | 普通版 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3 |
请求示例
{
"shop_id":"11",
"tid_infos": [
{
"tid": "168190061136123414",
"buyer_nick": "无聊小程序"
}
],
"vvtype":"3"
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/tbgetbyorder' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=m0nl579hm7be68aaiii88p4u80; _csrf=8b1448cbb701452960365c10c78d820c18f1df70c637e11a5d8b92619b5ca0d3a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22H1UzQGPu9nZjwv1HFBUu65Yuj2IOKKAl%22%3B%7D' \
--data-raw '{
"shop_id": "11",
"tid_infos": [
{
"tid": "99445459",
"buyer_nick": "无聊小程序",
"vvtype":"3"
}
]
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/tbgetbyorder',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"shop_id": "11",
"tid_infos": [
{
"tid": "99445459",
"buyer_nick": "无聊小程序",
"vvtype":"3"
}
]
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer XXXXXXXXXXXXXXXXXX',
'Content-Type: application/json',
'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=m0nl579hm7be68aaiii88p4u80; _csrf=8b1448cbb701452960365c10c78d820c18f1df70c637e11a5d8b92619b5ca0d3a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22H1UzQGPu9nZjwv1HFBUu65Yuj2IOKKAl%22%3B%7D'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"shop_id\": \"11\",\r\n \"tid_infos\": [\r\n {\r\n \"tid\": \"99445459\",\r\n \"buyer_nick\": \"无聊小程序\"\r\n }\r\n ]\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/erps/tbgetbyorder")
.method("POST", body)
.addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXXXX")
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=m0nl579hm7be68aaiii88p4u80; _csrf=8b1448cbb701452960365c10c78d820c18f1df70c637e11a5d8b92619b5ca0d3a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22H1UzQGPu9nZjwv1HFBUu65Yuj2IOKKAl%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
open_uids | OpenUidInfo [] | 买家 uid 对象 | |
tid | Number | 3468364924 | 订单 id |
buyer_nick | String | tesapo | 买家 nick |
buyer_open_uid | String | sfhks+dnk=OY | 买家 openuid |
withholding_money | Int | 该接口扣费金额(点券) | 1 |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1664157706,
"data": {
"open_uids": {
"open_uid_info": [
{
"buyer_nick": "tb_mylovelay",
"buyer_open_uid": "AAGojwxEAAocFId9iBFZ3_bi",
"tid": 1681900611362875477
}
]
},
"request_id": "15rmm6d6odwl7",
"withholding_money": 1
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |