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/goods/list
获取在售商品列表的基本信息,如果想获取商品详细信息请通过接口获取指定在售商品信息获取

请求参数

Header 参数
appID
string 
必需
默认值:
1
apiVersion
string 
必需
默认值:
2.0.0
traceID
string 
必需
默认值:
5831f960804c9217ec01e425b8cc76f5
timestamp
string 
必需
默认值:
1703592981
sign
string 
必需
默认值:
65987d12ae39b2c449b495c77c83c8ef

示例代码

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/goods/list' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
data
array [object {24}] 
必需
id
integer 
商品ID
必需
operatorType
integer 
商品分类类型
必需
name
string 
商品名称
必需
code
string 
商品编码
必需
des
string 
商品描述
必需
star
number  | integer 
推荐星级
必需
price
integer 
售价
必需
smsCode
integer 
必需
是否需要短信验证码,0否;1是
selectNumber
integer 
必需
选号模式,0不支持选号;1全国归属地;2固定归属地;3收货归属地;4省内随机;5省内自选
numberRegion
string 
号码归属地市编码
必需
uploadPhoto
string 
必需
上传照片模式,0无需上传;1需要上传
settleMode
string 
必需
结算模式,1日结秒返;2次月返佣;3月月返佣;4下单即返
orderTemplate
integer 
必需
tips
string 
商品主图
必需
details
array[string]
商品详情图列表
必需
sales
integer 
销量
必需
callDuration
integer 
通话时长
必需
commonFlow
integer 
通用流量
必需
fixedFlow
integer 
定向流量
必需
monthFee
integer 
月租
必需
favourMonthFee
integer 
优惠月租
必需
favourTerm
integer 
优惠期限
必需
tags
array[integer]
商品标签
必需
tagsSelect
array [object {6}] 
商品标签字典选项
必需
timestamp
integer 
必需
traceID
string 
必需
示例
{
  "code": 0,
  "message": "string",
  "data": [
    {
      "id": 0,
      "operatorType": 0,
      "name": "string",
      "code": "string",
      "des": "string",
      "star": 0,
      "price": 0,
      "smsCode": 0,
      "selectNumber": 0,
      "numberRegion": "string",
      "uploadPhoto": "string",
      "settleMode": "string",
      "orderTemplate": 0,
      "tips": "string",
      "details": [
        "string"
      ],
      "sales": 0,
      "callDuration": 0,
      "commonFlow": 0,
      "fixedFlow": 0,
      "monthFee": 0,
      "favourMonthFee": 0,
      "favourTerm": 0,
      "tags": [
        0
      ],
      "tagsSelect": [
        {
          "key": 0,
          "label": "string",
          "value": 0,
          "valueType": "string",
          "type": "string",
          "listClass": "string"
        }
      ]
    }
  ],
  "timestamp": 0,
  "traceID": "string"
}
上一页
获取店铺基础配置
下一页
发送短信验证码
Built with