查排名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参数为空 |
| 内容 | 详细 |
|---|---|
| 技术支持 | 查看 |
| 联系 | 查排名 |
| 联系微信 | 查排名 |