四、商品选号接口
4.1 接口请求
- 请求方式:Post
- 接收类型:form-data
- 说明:返回指定商品套餐可选号码,请避免频繁请求。
4.2 接口地址
https://haokaopenapi.lot-ml.com/api/order/PickNumber
4.3 请求参数
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| user_id | String | Y | 代理在172号卡登录账号 |
| Timestamp | String | Y | 时间戳(长度10位,与服务器时间不能超过5分钟) |
| prodID | String | Y | 商品ID |
| province | String | N | 省份;当商品套餐接口 numberSel 返回 2 时必填 |
| city | String | N | 城市;当商品套餐接口 numberSel 返回 2 时必填 |
| searchValue | String | N | 查询关键字(2-4位数字) |
| user_sign | String | Y | MD5加密(32位小写) |
MD5加密规则
Md5("city=" + city + "&prodID=" + prodID + "&province=" + province + "&searchCategory=3" + "&searchValue=" + searchValue + "&Timestamp=" + Timestamp + "&user_id=" + user_id + secret)- Secret(秘钥)追加到最后
- 前面的参数需按自然顺序排列
- 参考 MD5在线加密工具
4.4 返回参数
4.4.1 成功返回
json
{
"data": [
{
"type": "普通",
"number": "12345678901",
"numberId": "",
"numberPoolId": ""
}
],
"code": 0,
"message": "成功",
"errs": null
}| 字段 | 说明 |
|---|---|
| numberId | 号码ID,如返回需保存,下单时一同上传 |
| numberPoolId | 所属号池,如返回需保存,下单时一同上传 |
4.4.2 错误返回
json
{
"code": -1,
"message": "签名错误",
"errs": null
}