用户供应API接口文档
  1. 手工单推单报价设置
用户供应API接口文档
  • 开发指南
    • 接口签名介绍
    • 常见问题
  • 接口文档
    • 手工单取单API-供应文档
      • 概述
      • 渠道说明
      • 获取订单
        • 话费
        • 权益
        • 直播/游戏娱币
        • 流量
      • 上报订单
        • 上报API查单
          • 查单简介
        • 上报订单结果
      • 查询订单
        • 通过用户订单ID查询
        • 通过订单状态查询(默认只查询近2天)
        • 通过用户订单ID和订单状态查询
      • 获取渠道风控
        • 获取用户渠道定时风控信息
      • 渠道报价
        • 获取渠道报价信息
          • 话费
          • 权益
          • 直播/游戏娱币
        • 上报渠道报价信息
          • 话费
          • 权益
          • 直播/游戏娱币
    • 手工单推单API-供应文档
      • 渠道说明
      • 手工单推单开关配置
        • 推单开关查询
        • 推单开关修改
      • 手工单推单报价设置
        • 电影票
          • 获取省份和城市列表信息
          • 获取院线/影片/影厅信息接口
          • 获取影院列表接口
          • 获取报价规则列表
          • 获取报价规则详情信息
          • 保存报价规则信息
          • 更新报价规则供应状态
          • 删除报价规则信息
        • 获取商品(全部)接口
          POST
        • 修改商品报价(已供应)接口
          POST
        • 修改商品报价(话费省份报价)接口
          POST
        • 修改商品省份(仅适用于话费订单)接口
          POST
        • 修改供应商品终端限制(已供应)接口
          POST
      • 无服务器推单模式
        • 获取已经分配给用户的订单
      • 服务器推单模式-推单接口
        • 话费推单
        • 权益推单
        • 直播币/游戏币推单
        • 一手卡密推单
        • 电影票推单
        • 流量推单
      • 服务器推单模式-查单接口
        • 查单(话费、权益、直播币)
        • 电影票查单
        • 一手卡密查单
      • 上报订单
        • 上报API查单
          • 查单简介
        • 上报订单分润
          • 分润简介
        • 上报订单结果
    • 卡密卡券-供应文档
      • 提交卡密接口例子
      • 提交卡密
      • 订单查询
      • 修改折扣
      • 取消订单
      • 订单回调
      • 查询卡种各面值折扣
      • 查询卡种列表
      • 查询卡种详情信息
  1. 手工单推单报价设置

修改商品报价(话费省份报价)接口

开发中
POST
/userapi/sgd/editSupplyGoodManageStockWithProv
请求内容说明
请求数限制1秒1次

请求参数,其他公共参数请参考【接口签名介绍】#

名称类型必填说明
datastring是上报报价参数,参考下面 data 参数(此参数参与签名)

data请求参数#

名称类型必填说明
goodsarray - 多维是各个商品报价信息,参考下面 goods 参数
goods请求参数#
名称类型必填说明
goods_idint是商品ID
statusint是供应操作状态:1开启供应,2,关闭供应
prov_limit_typeint是限制省份类型:1支持全国,2限制省份;当值传1时,user_quote_type和external_code_link_type必须都为1;当值传2时,user_quote_type和external_code_link_type必须都为2
user_quote_typeint是省份报价类型:1统一报价,2按省份报价
external_code_link_typeint是关联外部编码类型:1统一编码,2按省份编码;
user_quote_paymentnumber否商品报价:需要在商品报价范围内报价;user_quote_type为1统一报价时,本字段必传;user_quote_type为2按省份报价时,则在省份信息里面上报
external_codestring否商品关联外部编码;external_code_link_type为1统一编码时,本字段必传;external_code_link_type为2按省份编码时,则在省份信息里面上报
prov_infoarray - 多维否省份报价信息;当prov_limit_type为2限制省份时,本字段必传;字段维度参考下面 prov_info 参数;
targetstring否指定充值号段,例1524578
prov_info 参数#
名称类型必填说明
provstring是省份名称
user_quote_paymentnumber否商品报价:需要在商品报价范围内报价;当user_quote_type为2按省份报价时,需要传值
external_codestring否省份关联外部编码;当external_code_link_type为2按省份编码时,需要传值
statusstring是省份报价状态,1上架,3下架;当user_quote_type为1统一报价且external_code_link_type为1统一编码时,status默认为上架

请求参数

Header 参数
appSecret
string 
可选
测试账号的appSecret,正式调用的时候,不用上传这个header字段的
示例值:
ada00d99f5cef43e
Body 参数application/json
app_key
string 
【公共参数】系统分配给商户的秘钥
必需
sign
string 
【公共参数】签名
必需
timestamp
integer 
【公共参数】Unix时间戳
必需
data
string 
报价参数
必需
由上面的data请求参数组合成JSON字符串
示例
{
  "app_key": "136174063",
  "sign": "7f9409f1d8ac46f74b162d6e1685db93",
  "timestamp": 0,
  "data":"{\"goods\":[{\"goods_id\":10000001,\"prov_limit_type\":1,\"user_quote_type\":1,\"external_code_link_type\":1,\"user_quote_payment\":9000,\"external_code\":\"123123\",\"status\":1},{\"goods_id\":10000002,\"prov_limit_type\":2,\"user_quote_type\":1,\"external_code_link_type\":1,\"user_quote_payment\":9000,\"external_code\":\"123123\",\"status\":1,\"prov_info\":[{\"prov\":\"内蒙古\",\"status\":1},{\"prov\":\"广东\",\"status\":3}]},{\"goods_id\":10000010,\"prov_limit_type\":2,\"user_quote_type\":2,\"external_code_link_type\":2,\"user_quote_payment\":9000,\"external_code\":\"123123\",\"status\":1,\"prov_info\":[{\"prov\":\"内蒙古\",\"user_quote_payment\":8900,\"external_code\":\"123123\",\"status\":1},{\"prov\":\"广东\",\"user_quote_payment\":9000,\"external_code\":\"111222\",\"status\":1}]}]}"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/userapi/sgd/editSupplyGoodManageStockWithProv' \
--header 'appSecret: ada00d99f5cef43e' \
--header 'Content-Type: application/json' \
--data-raw '{
  "app_key": "136174063",
  "sign": "7f9409f1d8ac46f74b162d6e1685db93",
  "timestamp": 0,
  "data":"{\"goods\":[{\"goods_id\":10000001,\"prov_limit_type\":1,\"user_quote_type\":1,\"external_code_link_type\":1,\"user_quote_payment\":9000,\"external_code\":\"123123\",\"status\":1},{\"goods_id\":10000002,\"prov_limit_type\":2,\"user_quote_type\":1,\"external_code_link_type\":1,\"user_quote_payment\":9000,\"external_code\":\"123123\",\"status\":1,\"prov_info\":[{\"prov\":\"内蒙古\",\"status\":1},{\"prov\":\"广东\",\"status\":3}]},{\"goods_id\":10000010,\"prov_limit_type\":2,\"user_quote_type\":2,\"external_code_link_type\":2,\"user_quote_payment\":9000,\"external_code\":\"123123\",\"status\":1,\"prov_info\":[{\"prov\":\"内蒙古\",\"user_quote_payment\":8900,\"external_code\":\"123123\",\"status\":1},{\"prov\":\"广东\",\"user_quote_payment\":9000,\"external_code\":\"111222\",\"status\":1}]}]}"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
响应状态码
必需
0 成功状态码;非0 错误状态码
message
string 
结果信息
必需
返回结果信息
stime
number 
必需
etime
number 
必需
data
object 
处理信息
必需
errorMsgs
修改失败的商品信息
必需
successMsgs
修改成功的商品信息
必需
示例
{
    "code": 0,
    "message": "",
    "stime": 1729137355.213657,
    "etime": 1729137355.821075,
    "data": {
        "successMsgs": {
            "10000078": "商品【10000078】报价成功并上架供应"
        },
        "errorMsgs": {
            "10000001": "商品【10000001】已被下架"
        }
    }
}
修改于 2025-04-28 06:51:15
上一页
修改商品报价(已供应)接口
下一页
修改商品省份(仅适用于话费订单)接口
Built with