接口地址: http://api.vv-tool.com/tool/erps/memo
接口介绍: 对一笔淘宝订单做备注(可以备注文字内容和旗帜颜色) 点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 详询: v:vtupaofu8888,扣账户余额
频率限制: 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 |
请求示例
tid:123456789
shop_id:123
memo:交易备注
flag:1
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/memo' \ --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/erps/memo', 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/erps/memo") .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" } }
响应代码
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |
401 | 身份凭证无效 | 在请求头中添加 access_token,重新更新 token |
404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |
614 | 交易不存在 | 请填写正确的订单号 |
614 | 参数无效,格式不对、非法值、越界等 | 请填写正确的参赛 |
614 | 必须是此交易的卖家或买家才能添加交易备注 | 查看是否程序出问导致添加交易备注的交易不属于该卖家,出现错误不要重试 |
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!