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/pretty/numberList
可以通过本接口来同步我方系统中的靓号数据。
注意事项:
1.
同步号码时对接方需要存储号码ID,提交靓号申请订单和验证号码状态时需要用到
2.
已同步过的号码可根据号码ID查询号码状态,判断号码是否可以下单

请求参数

Header 参数
appID
string 
必需
默认值:
1
apiVersion
string 
必需
默认值:
2.0.0
traceID
string 
必需
默认值:
5831f960804c9217ec01e425b8cc76f5
timestamp
string 
必需
默认值:
1703592981
sign
string 
必需
默认值:
65987d12ae39b2c449b495c77c83c8ef
Body 参数application/x-www-form-urlencoded
page
string 
必需
页码最小值不能低于1
示例值:
10000
pageSize
string 
必需
每页数量最大值不能大于200
示例值:
10
id
string 
号码ID
可选
poolId
string 
号码池ID
可选
number
string 
可选
查询号码数字(模糊匹配)
provinceId
string 
可选
归属地(省编码,这里采用的是通用编码)
cityId
string 
可选
归属地(市编码,这里采用的是通用编码)
operatorType
string 
可选
营运商类型,1移动 2联通 3电信 4广电
rule
string 
可选
号码规则,如:AAA。完整规则请到我方后台查看
status
string 
可选
号码状态 1销售中 2已锁号 3已预约 4已停售
createdAt
string 
可选
号码发布时间,请传入时间戳范围数组转字符串格式
示例值:
[1724256000000,1726847999999]
notContain
string 
可选
不含数字,可传入0~9,不要传1
contain
string 
可选
包含数字多,可传入0~9
price
string 
筛选价格区间
可选

示例代码

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/pretty/numberList' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;' \
--data-urlencode 'page=10000' \
--data-urlencode 'pageSize=10' \
--data-urlencode 'id=' \
--data-urlencode 'poolId=' \
--data-urlencode 'number=' \
--data-urlencode 'provinceId=' \
--data-urlencode 'cityId=' \
--data-urlencode 'operatorType=' \
--data-urlencode 'rule=' \
--data-urlencode 'status=' \
--data-urlencode 'notContain=' \
--data-urlencode 'contain=' \
--data-urlencode 'price='

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
data
object 
必需
list
array [object {36}] 
号码列表
必需
timestamp
integer 
必需
traceID
string 
必需
示例
{
  "code": 0,
  "message": "string",
  "data": {
    "list": [
      {
        "id": 0,
        "poolId": 0,
        "number": 0,
        "desc": "string",
        "originalPrice": 0,
        "price": 0,
        "costPrice": 0,
        "iccid": "string",
        "provinceId": 0,
        "cityId": 0,
        "innerFee": 0,
        "prestore": 0,
        "minConsume": 0,
        "agreementPeriod": 0,
        "operatorType": 0,
        "networkType": 0,
        "remark": "string",
        "isShow": 0,
        "createdBy": 0,
        "updatedBy": 0,
        "status": 0,
        "sort": 0,
        "createdAt": "string",
        "updatedAt": "string",
        "hkNumberPoolName": "string",
        "hkNumberPoolShowName": "string",
        "regionName": "string",
        "settleMode": 0,
        "operatorName": "string",
        "cityName": "string",
        "rule": "string",
        "highlight": "string",
        "gap": "string",
        "systemPrice": 0,
        "prettyCommission": 0,
        "packages": [
          "string"
        ]
      }
    ]
  },
  "timestamp": 0,
  "traceID": "string"
}
修改于 2024-11-14 15:32:15
上一页
IP定位
下一页
物联卡相关状态码说明
Built with