全部
电子面单
物流轨迹
物流发货
在线测试
备注 + 标旗
接口地址： http://api.vv-tool.com/tool/accounts/bcro
接口介绍： 对一笔淘宝订单做备注（可以备注文字内容和旗帜颜色） 点击查看详情
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 扣账户余额
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺 ID |
| tid | Number | 是 | 交易编号 |
| memo | string | 否 | 交易备注。最大长度： 1000 个字节 |
| flag | string | 否 | 交易备注旗帜，可选值为：0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色)，默认值为 0 |
| vvtype | int | 否 | 普通版 1，不传默认 1，增强版 2，增强版的需要传参 2，标准版 3,需要标准版的传 3 |
请求示例
tid:123456789
shop_id:123
memo:交易备注
flag:1
请求代码示例
cURL请求代码示例
curl --location --request POST "http://api.vv-tool.com/tool/accounts/bcro" \
--header "Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx" \
--header "Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D" \
--form "tid="123456789"" \
--form "memo="交易备注"" \
--form "shop_id="123"" \
--form "flag="1""
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.vv-tool.com/tool/accounts/bcro",
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 => array("tid" => "123456789","memo" => "交易备注","shop_id" => "123","flag" => "1"),
CURLOPT_HTTPHEADER => array(
"Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx",
"Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
.addFormDataPart("tid","123456789")
.addFormDataPart("memo","交易备注")
.addFormDataPart("shop_id","123")
.addFormDataPart("flag","1")
.build();
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/accounts/bcro")
.method("POST", body)
.addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
.addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| url | string | url |
| code | int | 错误码 0 为成功 |
| msg | string | 返回码描述 |
| msec | int | 接口执行时间 |
| time | int | 接口返回时间 |
| tid | int | 交易编号 (父订单的交易编号) |
| created | Date | 交易创建时间。格式：yyyy-MM-dd HH:mm:ss |
| withholding_money | int | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1046,
"time": 1617262617,
"data": {
"withholding_money": 1,
"modified": "2021-04-01 15:36:57",
"tid": "123456789"
}
}