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