查排名API接口介绍 查排名API 查排名API 查排名API
【查排名API】千人前面下面的排名千变万化,有时候怎么说呢?不查不知道,一查吓一跳
接口状态:正常 更新时间:2019-06-16
请求方式: utf-8
支持格式: json ,所有接口的返回都是 json 对象
接口地址: 查看
参数说明: 数据以POST方式传输,utf-8格式,validation校验码为MD5(taskId+partnerId+密码)
返回结果: 任务还没有完成的情况: {"taskId":1840670,"message":" 任 务 还 没 完 成 ","wangwang":null,"wangwangInfo":null,"peopleTagInfo":null,"tagInfo":null,"blackInf o":null,"finished":false}
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
-- | -- | - | 查号接口说明 |
partnerId | long | 是 | ID |
wangwang | String | 是 | 小号 |
validation | String | 是 | 对身份的验证 |
-- | -- | - | 查询任务接口说明 |
partnerId | long | 是 | ID |
taskId | long | 是 | 任务 id |
validation | String | 是 | 对身份的验证 |
名称 | 类型 | 说明 |
---|---|---|
success | boolean | True 表示成功,false 表示失败 |
tasked | Long | 任务 id |
message | String | 消息 |
{ "taskId": 1840670, "message":"", "wangwang": "xxxxx", "wangwangInfo": { "vipInfoLevel": 3, "vipLevel": 0, }, "blackInfo": { "pitu": 0, //排名位置次数 }, "finished": true }
请求方式: utf-8 ,注意中文乱码
支持格式: json ,所有接口的返回都是 json对象
补充说明: 系统提供一个 partnerId 和 password 进行操作。系统设置了一个 apiOrderId 的概念,apiOrderId 是 请求下单 的唯一 标识码,字符串格式,不允许 重复。apiOrderId 可以自定义,只要保证 不重复即可。不要随便更改 apiOrderId, 只要 apiOrderId 不 变,多次请求就不会重复扣费。如果有一次请求返回单号失败,下一次 重新请求保持 apiOrderId 不变,就能防止重复扣费
接口地址: 点击获取
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
-- | -- | -- | 获取token参数说明 |
partnerId | Long | 是 | 系统提供的合作商 ID |
md5Secret | String | 是 | 系统提供的密钥,然后对密钥进行 md5 加密 |
-- | -- | -- | 获取余额参数说明 |
token | String | 是 | 通过上一个接口获取的 token |
-- | -- | -- | 获取单号参数说明 |
partnerId | Long | 是 | ID |
itemId | Long | 是 | ID |
orderParams | String | 是 | 订单内容的 json 格式,是一个json 的数组对象, 数组中一次最 多不能超过 5 个订单 |
validation | String | 是 | 对身份的验 |
-- | -- | -- | orderParams 的详细格式 |
apiOrderId | String | 是 | 唯一标识,自定义 ID |
buyerName | String | 是 | 收件人姓名 |
buyerMobile | String | 是 | 收件人手机 |
buyerAddr | String | 是 | 收件人地址 |
buyerAddrCode | String | 否 | 收件人邮编 |
storeType | Int | 是 | |
kuaidiName | String | 否 | y |
名称 | 类型 | 说明 |
---|---|---|
-- | - | 获取token返回参数 |
result | Int | 返回 1 表示成功,返回其他结果请见 下面 的错误 code |
message | String | 消息通知 |
token | String | token 结果 |
-- | -- | 获取余额返回参数 |
result | Int | 返回 1 表示成功,返回其他结果请见 下面 的错误 code |
message | String | 消息通知 |
money | int | 余额以 分 为单位返回,int 格式 |
-- | -- | orderParams返回参数 |
result | Int | 返回 1 表示成功,返回其他结果请见 下面 的错误 code |
message | String | 消息通知 |
orders | String | 订单结果,json 数组格式 |
-- | -- | orders返回参数 |
orderResult | Int | 返回 1 表示成功,返回其他结果请见 下面 的错误 code |
apiOrderId | String | 订单唯一标识 |
expressNo | String | 返回的面单号 |
{ "apiOrderId": "test_3", "buyerName": "张三", "buyerMobile": "13555555555", "buyerAddr": "湖北省武汉市江汉区 XX 路 XX 号", "buyerAddrCode": "430000" } "返回结果示例: { "result": 1, "buyerName": "张三", ""orders": [ { "orderResult": 1, "apiOrderId": "test_3", "expressNo": "6000002998" }] } "接口返回代码标识":"📢 代码1:说明:成功 代码2:说明:身份验证不通过,partnerId 错误,或者 密码 错误,或 者 token 过期 代码3:说明:Ip 错误 代码4:说明:订单请求参数格式错误 代码5:说明:订单库存不足 代码6:说明:账户余额不足 代码8:说明:apiOrderId 重复 代码101:说明:单个订单获取 单号失败 代码999:说明:未知系统错误 "礼品编码标识":"📢 编码700004:类型:洁厕灵 编码700005:类型:餐巾纸 1 包 编码700006:类型:餐巾纸 3 包
请求方式: utf-8 格式的数据,注意中文乱码
支持格式: json
对同一个任务 不要多线程发布或者取消,防止重复操作!
接口地址: 点击获取
数据以 POST 方式传输, utf-8 格式
validation 校验码为 MD5(orderParams + partnerId + 密码), 密码为系统提供 给合作商。
如orderParams={},partnerId=10000,密码=123456, 那么MD5({}10000123456), validation 的最终结果为 7b909d4bccf7f755ac2f21a80956d180
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
-- | -- | - | orderParams 的详细格式 |
apiOrderIds | String | 是 | 请求唯一标识,自定义 ID,不 同的任务不能重复,防止重复生成 |
viewType | int | 是 | 目前只支持 0 |
itemLink | String | 是 | tb 商品链接 |
searchWord | String | 是 | 搜索关键词 |
clickNum | Int | 是 | 点击数 |
名称 | 类型 | 说明 |
---|---|---|
-- | -- | orderParams 的详细格式 |
success | boolean | true 表示成功,false 表示失败 |
message | String | 消息 |
更多参数联系客服 | -- | 唯一客服QQ:1967714688 |
"此项目参数较多查看API参数文件
错误码 | 说明 |
---|---|
101 | appkey |
102 | 单品请求id为空 |
103 | 没有数据 |
123 | 服务器繁忙 |
111 | AppKey无效 |
112 | type参数为空 |
内容 | 详细 |
---|---|
技术支持 | 查看 |
联系 | 查排名 |
联系微信 | 查排名 |