V2.0开放接口
  1. 号卡/宽带业务
V2.0开放接口
  • 对接前必看
  • 号卡/宽带业务
    • 号卡订单状态码说明
    • 关于下单省市区编码
    • 获取店铺基础配置
      GET
    • 获取在售商品列表
      POST
    • 发送短信验证码
      POST
    • 预选下单号码
      POST
    • 提交申请订单
      POST
    • 订单查询
      POST
    • 获取指定商品详细信息
      POST
    • 上传证件照
      POST
    • 订单回调
      POST
    • IP定位
      GET
  • 靓号业务
    • 获取靓号列表
      POST
  • 物联卡业务
    • 物联卡相关状态码说明
    • 批量查询卡板信息(100张)
      POST
    • 批量订阅卡板信息(100张)
      POST
    • 批量查询卡板最新状态(10张)
      POST
    • 批量查询卡板实时流量(10张)
      POST
    • 批量查询卡板指定月流量(10张)
      POST
    • 批量停机(100张)
      POST
    • 批量复机(100张)
      POST
    • 单卡机卡绑定
      POST
    • 单卡限速
      POST
    • 单卡解除限速
      POST
    • 单卡/设备订购套餐包
      POST
    • 获取官方实名链接
      POST
    • 查询卡板操作记录
      POST
    • 查询账户资产
      POST
    • 获取移动流量池Token
      POST
    • 查询设备信息
      POST
    • 查询设备流量
      POST
    • 设备切换网络
      POST
  1. 号卡/宽带业务

订单查询

POST
/openapi/order/search

特别注意#

对接方应该对订单查询接口请求频率进行控制,最高1分钟内不能超过60次请求,否则我方将对其进行查询限制。
强烈建议在提交申请订单时设置回调地址,由我方主动推送订单状态变化

注意事项#

1.
系统订单号和自定义订单号至少有一个不为空
2.
当系统订单号和自定义订单号都传递时,将作为双重查询条件来过滤订单
3.
单次最多可以查询不超过10单

请求参数

Header 参数
appID
string 
必需
默认值:
1
apiVersion
string 
必需
默认值:
2.0.0
traceID
string 
必需
默认值:
5831f960804c9217ec01e425b8cc76f5
timestamp
string 
必需
默认值:
1703592981
sign
string 
必需
默认值:
65987d12ae39b2c449b495c77c83c8ef
Body 参数application/x-www-form-urlencoded
keyNos
string 
可选
系统订单号(我方订单号)
示例值:
["QL20231130075145MjqIiBtm"]
customNos
string 
可选
自定义订单号(对接方订单号)
示例值:
["202212221410191236726359", "202212221421154314916804"]

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1:2000/openapi/order/search' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;' \
--data-urlencode 'keyNos=["QL20231130075145MjqIiBtm"]'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
data
object 
必需
list
array [object {26}] 
订单列表
必需
timestamp
integer 
必需
traceID
string 
必需
示例
{
  "code": 0,
  "message": "string",
  "data": {
    "list": [
      {
        "id": 0,
        "goodsId": 0,
        "goodsName": "string",
        "keyNo": "string",
        "selectPhone": "string",
        "certName": "string",
        "certNo": "string",
        "contactPhone": "string",
        "expressName": "string",
        "expressNo": "string",
        "address": "string",
        "createdAt": "string",
        "status": 0,
        "statusName": "string",
        "applyFailReason": "string",
        "settleStatus": 0,
        "settleReward": 0,
        "settleFailReason": "string",
        "settleAt": "string",
        "settleDetails": [
          {
            "month": 0,
            "settleStatus": 0,
            "settleFailReason": "string",
            "settleReward": 0,
            "updatedAt": "string"
          }
        ],
        "firstRechargeStatus": 0,
        "firstRechargeAt": "string",
        "firstRechargeMoney": 0,
        "flagRemark": "string",
        "customNo": "string",
        "activateAt": "string"
      }
    ]
  },
  "timestamp": 0,
  "traceID": "string"
}
上一页
提交申请订单
下一页
获取指定商品详细信息
Built with