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/details
可以查询已经下架的商品,商品下架后佣金相关参数无效

请求参数

Header 参数
appID
string 
必需
默认值:
1
apiVersion
string 
必需
默认值:
2.0.0
traceID
string 
必需
默认值:
5831f960804c9217ec01e425b8cc76f5
timestamp
string 
必需
默认值:
1703592981
sign
string 
必需
默认值:
65987d12ae39b2c449b495c77c83c8ef
Body 参数application/x-www-form-urlencoded
id
string 
商品ID
可选
示例值:
1409

示例代码

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/details' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;' \
--data-urlencode 'id=1409'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
data
object 
必需
id
integer 
对接商品ID
必需
channelId
integer 
必需
operatorType
integer 
商品分类
必需
name
string 
商品名称
必需
code
string 
商品编码
必需
des
string 
商品描述
必需
tags
array[integer]
商品标签
必需
shareName
string 
必需
star
number 
推荐星级
必需
price
integer 
售价
必需
tips
string 
商品主图
必需
details
array[string]
商品详情图列表
必需
posterId
integer 
必需
orderTemplate
integer 
必需
backgroundColor
string 
主题背景色
必需
settleMode
integer 
必需
结算模式,1日结秒返;2次月返佣;3月月返佣;4下单即返
compliance
string 
结算要求
必需
commission
integer 
达标佣金
必需
monthCommission
array [object {2}] 
必需
月返佣金,仅在settleMode=3时有效
matter
string 
必需
注意事项,html格式
dockGoodId
string 
必需
dockCustom1
string 
必需
dockCustom2
string 
必需
dockCustom3
string 
必需
dockCustom4
string 
必需
dockCustom5
string 
必需
dockCustom6
string 
必需
dockCustom7
string 
必需
dockCustom8
string 
必需
dockCustom9
string 
必需
dockCustom10
string 
必需
smsCode
integer 
必需
是否需要短信验证码,0否;1是
selectNumber
integer 
必需
选号模式,0不支持选号;1全国归属地;2固定归属地;3收货归属地;4省内随机;5省内自选
numberRegion
string 
号码归属地,市编码
必需
numberPoolId
integer 
必需
uploadPhoto
integer 
必需
上传照片模式,0无需上传;1需要上传
provinceCode
string 
省市区编码名称
必需
certNoMode
integer 
证件验证,1是
必需
isOffline
integer 
是否线下自提,1是
必需
orderRemark
integer 
是否开启下单备注
必需
limitRule
object 
下单限制规则
必需
alarmRules
array[string]
报警规则
必需
noticeRules
null 
通知规则
必需
callDuration
integer 
通话时长
必需
commonFlow
integer 
通用流量
必需
fixedFlow
integer 
定向流量
必需
monthFee
integer 
月租
必需
favourMonthFee
integer 
优惠月租
必需
favourTerm
integer 
优惠期限
必需
sort
integer 
必需
status
integer 
必需
商品状态,1上架中,其他已下架。非1状态佣金属性无效
createdBy
integer 
必需
updatedBy
integer 
必需
offShelfAt
null 
下架时间
必需
createdAt
string 
必需
updatedAt
string 
必需
saleAuthority
boolean 
必需
allTags
array [object {6}] 
完整标签选项
必需
timestamp
integer 
必需
traceID
string 
必需
示例
{
  "code": 0,
  "message": "string",
  "data": {
    "id": 0,
    "channelId": 0,
    "operatorType": 0,
    "name": "string",
    "code": "string",
    "des": "string",
    "tags": [
      0
    ],
    "shareName": "string",
    "star": 0,
    "price": 0,
    "tips": "string",
    "details": [
      "string"
    ],
    "posterId": 0,
    "orderTemplate": 0,
    "backgroundColor": "string",
    "settleMode": 0,
    "compliance": "string",
    "commission": 0,
    "monthCommission": [
      {
        "commission": "string",
        "month": "string"
      }
    ],
    "matter": "string",
    "dockGoodId": "string",
    "dockCustom1": "string",
    "dockCustom2": "string",
    "dockCustom3": "string",
    "dockCustom4": "string",
    "dockCustom5": "string",
    "dockCustom6": "string",
    "dockCustom7": "string",
    "dockCustom8": "string",
    "dockCustom9": "string",
    "dockCustom10": "string",
    "smsCode": 0,
    "selectNumber": 0,
    "numberRegion": "string",
    "numberPoolId": 0,
    "uploadPhoto": 0,
    "provinceCode": "string",
    "certNoMode": 0,
    "isOffline": 0,
    "orderRemark": 0,
    "limitRule": {
      "age": [
        "string"
      ],
      "fraudFilter": true,
      "noShippingKeyword": [
        "string"
      ],
      "noShippingRegion": [
        "string"
      ],
      "onlyShippingRegion": [
        "string"
      ],
      "person": {
        "count": 0,
        "cycle": 0
      }
    },
    "alarmRules": [
      "string"
    ],
    "noticeRules": null,
    "callDuration": 0,
    "commonFlow": 0,
    "fixedFlow": 0,
    "monthFee": 0,
    "favourMonthFee": 0,
    "favourTerm": 0,
    "sort": 0,
    "status": 0,
    "createdBy": 0,
    "updatedBy": 0,
    "offShelfAt": null,
    "createdAt": "string",
    "updatedAt": "string",
    "saleAuthority": true,
    "allTags": [
      {
        "key": 0,
        "label": "string",
        "value": 0,
        "valueType": "string",
        "type": "string",
        "listClass": "string"
      }
    ]
  },
  "timestamp": 0,
  "traceID": "string"
}
修改于 2024-11-14 15:30:56
上一页
订单查询
下一页
上传证件照
Built with