V2.0开放接口
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.PC端后台请进入【系统设置】-【个人设置】-【开放API对接】，找到以下参数：
image.png
2.移动端后台请到【API对接】中查看
c0965356-cb05-44b9-80ed-774119de245b.png

对接地址#

假设代理后台地址为：https://xxx.cn/admin
则对接地址为：https://xxx.cn

接口签名#

签名参数请放在Header请求头中，下面对签名参数进行说明
参数名称注释
appID应用ID，从代理后台获取
apiVersion当前API版本号，固定填2.0.0
timestamp当前时间戳（10位），与东8时区时差最大不能超过10分钟
traceID链路ID，32位16进制随机字符串(小写)。OpenTelemetry规范，需保证唯一性。
signmd5签名运算值(32位小写)，详细签名算法请看下方说明

签名算法#

将appID、apiVersion、traceID、timestamp、API密钥按顺序拼接成字符串，然后运行md5算法，得出的值即为签名
下面是一个简单的示例：
假设参数值：
appID=qwe123
apiVersion=2.0.0
traceID=5831f960804c9217ec01e425b8cc76f5
timestamp=1698587220
API密钥=C55rqUa6AvKyuNMYYvoYCSR1BBfSPWK7

则拼接字串符为：
qwe1232.0.05831f960804c9217ec01e425b8cc76f51698587220C55rqUa6AvKyuNMYYvoYCSR1BBfSPWK7

将上方字符串运算md5后得到签名结果：
c07a95dbddc1aa915f323cee747aa576

md5运算采用的是32位小写
修改于 2025-02-22 06:41:02
下一页
号卡订单状态码说明
Built with