点击打开Apipst地址（会及时更新)
下面的文档可能不会及时更新
全局公共参数
全局Header参数
| 参数名 | 示例值 | 参数描述 |
|---|---|---|
| 暂无参数 |
全局Query参数
| 参数名 | 示例值 | 参数描述 |
|---|---|---|
| 暂无参数 |
全局Body参数
| 参数名 | 示例值 | 参数描述 |
|---|---|---|
| 暂无参数 |
全局认证方式
text
noauth全局预执行脚本
javascript
暂无预执行脚本全局后执行脚本
javascript
暂无后执行脚本/商户对接API
text
用于购买商品等Header参数
| 参数名 | 示例值 | 参数描述 |
|---|---|---|
| 暂无参数 |
Query参数
| 参数名 | 示例值 | 参数描述 |
|---|---|---|
| 暂无参数 |
Body参数
| 参数名 | 示例值 | 参数描述 |
|---|---|---|
| 暂无参数 |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本/商户对接API/对接流程
text
> 第一步
联系站长要商户ID 商户KEY
> 第二步
文档里面的http://www.sa.com 修改成对应站长的域名/商户对接API/签名生成规则
text
1、除sign字段外，所有参数按照字段名的ascii码从小到大排序后使用QueryString的格式（即key1=value1&key2=value2…）拼接而成，空值不传递，不参与签名组串。
2、签名原始串中，字段名和字段值都采用原始值，不进行URL Encode。
3、拼接好的字符串+key 取MD5值
PHP签名生成示例：
/*
*$param 下单参数
*$userkey 商户密钥
*/
private function getKkySign($param,$userkey){
ksort($param); //排序post参数
reset($param); //内部指针指向数组中的第一个元素
$signtext='';
foreach ($param AS $key => $val) { //遍历POST参数
if ($val == '' || $key == 'sign') continue; //跳过这些不签名
if ($signtext) $signtext .= '&'; //第一个字符串签名不加& 其他加&连接起来参数
$signtext .= "$key=$val"; //拼接为url参数形式
}
$newsign=md5($signtext.$userkey);
return $newsign;
}/商户对接API/统一下单接口
text
**www.sa.com换成站长的商城域名**
重要提示：
下单返回是json格式数据，code=1是成功 code非1可以代表失败
下单返回如果不是json格式 一定不能当做失败处理，这种需要手动去核实
重要提示：
下单返回是json格式数据，code=1是成功 code非1可以代表失败
下单返回如果不是json格式 一定不能当做失败处理，这种需要手动去核实
重要提示：
下单返回是json格式数据，code=1是成功 code非1可以代表失败
下单返回如果不是json格式 一定不能当做失败处理，这种需要手动去核实接口状态
已完成
接口URL
/dockapi/index/buy
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | String | 是 | 商户ID,联系站长获取 |
| goodsid | 4555 | String | 是 | 商品编码 |
| buynum | 1 | String | 是 | 购买数量 |
| outorderno | - | String | 否 | 商户自传单号，可空，如填写请保证唯一 |
| maxmoney | - | String | 否 | 最大进货金额（订单的总金额，不是商品单价），防止进货金额超过自己平台的价格造成亏本 |
| attach | [{"attachtype":1,"value":"458454455"},{"attachtype":3,"value":"艾欧尼亚"}] | String | 否 | 充值信息，直冲需要传递，卡密的无需传递， |
简单字段：
单个充值字段13088888888 或者 ["13088888888"]
多个充值字段["13088888888","18888888888"] 对顺序有要求
复杂字段(按需求传递，对顺序无要求)：
[{"attachtype":1,"value":"这里充值帐号"},{"attachtype":2,"value":"游戏服务器"},{"attachtype":3,"value":"游戏大区"},{"attachtype":4,"value":"游戏名称"}] 例子：英雄联盟传值[{"attachtype":1,"value":"458454455"},{"attachtype":3,"value":"艾欧尼亚"}]
attachtype的值 1 充值帐号 2 游戏服务器 3 游戏大区 4 游戏名称 5省份 6市区 7证件号码 8证件类型 9用户姓名 10 联系手机 11 用户ID 12 游戏充值方式 13 帐号类型
callbackurl | - | String | 否 | 回调地址 sign | f18e25ba2bfc67a1ab8383c34f4d2afb | String | 是 | 签名，详见签名生成规则 attachjson | - | String | 否 | 拓展参数，例子{"BuyerArea":"北京","BuyerIp":"127.0.0.1","BuyerUid":"AA_XXXXXXX"} 例如有的地区QB需要传递IP,如下填写就可以了{"BuyerIp":"127.0.0.1"} BuyerArea：下单用户区域 BuyerIp：下单用户IP地址 BuyerUid:下单用户ID(比如淘宝买家昵称id,拼多多买家昵称id,微信OPEINID等) sellmoney | 0 | String | 否 | 卖给客户的总价，站长自用帐号使用，其他帐号可忽略此参数
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{"code":1,"msg":"下单成功","orderno":"D202305121826373518890321","outorderno":"202305121819421","money":"33","buynum":"1","cardlist":["联系客服联系客服"]}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Integer | 1=成功 其他=失败 |
| msg | 下单成功 | String | 提示信息 |
| orderno | D202305121826373518890321 | String | 本系统返回订单号 |
| outorderno | 202305121819421 | String | 商户自传单号， |
| money | 33 | String | 订单消费金额 |
| buynum | 1 | String | 购买数量 |
| cardlist | 联系客服联系客服 | String | 卡密信息，直冲的这项没有 |
错误响应示例
javascript
{"code":-1,"msg":"效验sign失败，正确SIGN拼接attach=['13088888888']&buynum=1&goodsid=4092&outorderno=20230512181942&userid=1004+key"}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | -1 | Integer | 1=成功 其他=失败 |
| msg | 效验sign失败，正确SIGN拼接attach=['13088888888']&buynum=1&goodsid=4092&outorderno=20230512181942&userid=1004+key | String | 提示信息 |
/商户对接API/订单异步回调
text
**订单成功或者失败触发回调，如果订单是成功的后期退款了不会再次回调！**
**接收到推送之后，请返回字符串ok（不区分大小写），否则视为不成功，将会按照时间阶梯延迟5\|10\|15\|20\|25分钟继续进行通知回调，**接口状态
已完成
接口URL
您提交的回调URL
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| orderno | 11111 | String | 是 | 开发者传递的订单编号 |
| outorderno | 22222 | String | 是 | 卡卡云下单返回的单号 |
| userid | 1024 | String | 是 | 商户ID |
| status | 5 | String | 是 | 3=进行中 4=充值失败 5=充值成功 |
| refundstatus | 0 | String | 是 | 0 未退款 1 已全部退 2 部分退款 3 仅仅标记退款 4 原路退款 |
| money | 8.25 | String | 是 | 订单消耗金额 |
| refundmoney | 2.56 | String | 是 | 订单退款金额 |
| receipt | 充值成功 | String | 是 | 订单回执 |
| refundreceipt | 上游风控 | String | 是 | 退款回执 |
| create_time | 1654854545 | String | 是 | 订单创建时间10位时间戳，请自行转换 |
| update_time | 1654875498 | String | 是 | 订单最后操作时间10位时间戳，请自行转换 |
| timestamp | 1685487545 | String | 是 | 推送时间戳 |
| sign | 54584545511 | String | 是 | 参考签名规则 |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
OK/商户对接API/获取商户信息
text
www.sa.com
换成站长的商城域名
<br>
<br>接口状态
已完成
接口URL
/dockapi/index/userinfo
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | String | 是 | 商户ID,联系站长获取 |
| sign | a767f9003870bee5345e474ae79574ed | String | 是 | 签名，详见签名生成规则 |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{"code":1,"msg":"查询成功","data":{"money":"2.0000","creditquota":"0.00","group_id":7}}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Integer | 1=成功 其他=失败 |
| msg | 查询成功 | String | 提示信息 |
| data | - | - | - |
| data.money | 2.0000 | String | 账面余额 |
| data.creditquota | 0.00 | String | 信用额度 |
| data.group_id | 7 | Integer | 分组ID |
错误响应示例
javascript
{"code":-1,"msg":"效验sign失败，正确SIGN拼接userid=1004+key"}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | -1 | Integer | 1=成功 其他=失败 |
| msg | 效验sign失败，正确SIGN拼接userid=1004+key | String | 提示信息 |
/商户对接API/查询订单详情
text
www.sa.com
换成站长的商城域名
<br>
<br>接口状态
已完成
接口URL
/dockapi/index/queryorder
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | String | 是 | 商户ID,联系站长获取 |
| orderno | D202311080058493071972325 | String | 否 | 卡卡云订单号(自传订单号二选一) |
| dockapiorderno | - | String | 否 | 自传订单号(卡卡云订单号二选一) |
| sign | 0beb33fa76546faed9d9b4cd0932215e | String | 是 | 签名，详见签名生成规则 |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{"code":1,"msg":"查询成功","data":{"orderno":"D202311080058493071972325","outorderno":"20231108200040011100510096612111","dockapiorderno":"D202311080058493071972325","money":"0.0100","buynum":1,"goodsprice":"0.0100","goodsid":4547,"status":1,"refundmoney":"0.0000","refundstatus":0,"payrefundspeed":0,"banstatus":0,"mobile":"","receipt":"","create_time":1699376329,"update_time":1699376352},"aftersales":[],"cardlist":["2\r"]}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Integer | 1=成功 其他=失败 |
| msg | 查询成功 | String | 提示信息 |
| data | - | - | - |
| data.orderno | D202311080058493071972325 | String | 卡卡云订单号 |
| data.outorderno | 20231108200040011100510096612111 | String | 外部订单号 |
| data.dockapiorderno | D202311080058493071972325 | String | 自传订单号 |
| data.money | 0.0100 | String | 订单金额 |
| data.buynum | 1 | Integer | 购买数量 |
| data.goodsprice | 0.0100 | String | 商品单价 |
| data.goodsid | 4547 | Integer | 商品ID |
| data.status | 1 | Integer | 订单状态 0=已付款 1=已提取 2=未付款 3=进行中 4=撤回 5=充值成功 |
| data.refundmoney | 0.0000 | String | 退款金额 |
| data.refundstatus | - | Integer | 0=未退款 1=已退款 |
| data.payrefundspeed | - | Integer | - |
| data.banstatus | - | Integer | 0=正常 1=禁用订单 |
| data.mobile | - | String | 联系手机 |
| data.receipt | - | String | 回执 |
| data.create_time | 1699376329 | Integer | 创建时间 |
| data.update_time | 1699376352 | Integer | 更新时间 |
| aftersales | - | Object | 售后消息 |
| cardlist | 2 | String | 卡密信息 |
错误响应示例
javascript
{"code":-1,"msg":"效验sign失败，正确SIGN拼接dockapiorderno=2012545111&orderno=D20215122222221&userid=1004+key"}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | -1 | Integer | 1=成功 其他=失败 |
| msg | 效验sign失败，正确SIGN拼接dockapiorderno=2012545111&orderno=D20215122222221&userid=1004+key | String | 提示信息 |
/商户对接API/获取所有商品分类
text
接口频率限制：2秒一次接口状态
已完成
接口URL
/dockapi/v2/getallgoodsgroup
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | - | 是 | 商户ID |
| sign | - | 是 | 签名sign,参考签名生成规则 |
认证方式
text
noauth预执行脚本
javascript
apt.globals.set("sign", CryptoJS.MD5('userid=1004995f731ba29dc9ffece09e4c346e3900').toString());
console.log(apt.globals.get("sign"));后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{
"code": 1,
"msg": "查询成功",
"data": [
{
"groupname": "特价封面1",
"groupaliasname": "特价封面1",
"groupid": 195,
"groupimgurl": "http://img.yxp8.cn/a2cd7a6c50f1b7402634ecee46bd4c8b.jpg",
"brandid": 2,
"brandname": "影视会员专区",
"brandimgurl": ""
},
{
"groupname": "特价封面2",
"groupaliasname": "特价封面2",
"groupid": 196,
"groupimgurl": "http://img.yxp8.cn/a2cd7a6c50f1b7402634ecee46bd4c8b.jpg",
"brandid": 2,
"brandname": "影视会员专区",
"brandimgurl": ""
}
]
}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Number | code返回1成功，其他均失败 |
| msg | 查询成功 | String | 返回文字描述 |
| data | - | Object | 返回数据 |
| data.groupname | 特价封面1 | String | 分类名称 |
| data.groupaliasname | 特价封面1 | String | 分类别名（也可称为楼层名字） |
| data.groupid | 195 | Number | 分类ID |
| data.groupimgurl | http://img.yxp8.cn/a2cd7a6c50f1b7402634ecee46bd4c8b.jpg | String | 分类图标 |
| data.brandid | 2 | Number | 分类所属品牌ID |
| data.brandname | 影视会员专区 | String | 分类品牌名字 |
| data.brandimgurl | - | Object | 品牌图标 |
错误响应示例
javascript
{
"code": -1,
"msg": "效验sign失败，正确SIGN拼接userid=1004+key"
}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | -1 | Number | - |
| msg | 效验sign失败，正确SIGN拼接userid=1004+key | String | 返回文字描述 |
/商户对接API/获取所有商品(即将取消,新接口上线后一个月内取消)
text
[签名生成规则](https://console-docs.apipost.cn/preview/064ad24ed549dda7/6276496fb193225a?target_id=f14f6b70-8989-4448-b9fe-f8cc65efbc6e)
限制说明：频率3秒一次，limit最高20条一页(禁止高频繁访问)接口状态
已完成
接口URL
/dockapi/v2/getallgoods
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | String | 是 | 商户ID |
| goodstype | 1 | String | 否 | - |
| goodsgroupid | - | String | 否 | - |
| goodsname | - | String | 否 | - |
| limit | - | String | 否 | - |
| page | - | String | 否 | - |
| sign | de76e075dd7d880d66984a2c9f733238 | String | 是 | 签名生成规则 |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{"code":1,"msg":"查询成功","data":[{"goodsid":4352,"imgurl":"","goodsname":"454545454545454迅雷超级会员-月卡4545","goodsprice":"21.8800","goodsstatus":1,"goodstype":1,"stock":111111,"buyminnum":1,"goodsgroupid":305},{"goodsid":4353,"imgurl":"","goodsname":"45454545迅雷快鸟会员-月卡4545","goodsprice":"10.2000","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305},{"goodsid":4098,"imgurl":"http:\/\/img.yxp8.cn\/7cc9996e015655482a832d9a53eed8bc.jpg","goodsname":"45454545WPS稻壳会员年卡WPS稻壳会员年卡WPS稻壳会员年卡WPS稻壳会员 4545","goodsprice":"86.8800","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":196},{"goodsid":4354,"imgurl":"","goodsname":"45454545迅雷快鸟会员-半年4545","goodsprice":"61.0000","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305},{"goodsid":4099,"imgurl":"http:\/\/img.yxp8.cn\/ac8f49dac741467dce68df991ada1015.jpeg","goodsname":"45454545WPS稻壳会员季卡4545","goodsprice":"36.9200","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":196},{"goodsid":4355,"imgurl":"","goodsname":"45454545迅雷快鸟会员-年卡4545","goodsprice":"122.0000","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305},{"goodsid":4100,"imgurl":"","goodsname":"45454545WPS稻壳会员月卡4545","goodsprice":"21.0000","goodsstatus":1,"goodstype":1,"stock":176,"buyminnum":1,"goodsgroupid":197},{"goodsid":4356,"imgurl":"","goodsname":"45454545Keep会员卡-月卡4545","goodsprice":"15.7500","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305},{"goodsid":4101,"imgurl":"","goodsname":"45454545WPS超级会员年卡4545","goodsprice":"171.4700","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":197},{"goodsid":4357,"imgurl":"","goodsname":"Keep会员卡-季卡","goodsprice":"42.8400","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305},{"goodsid":4102,"imgurl":"","goodsname":"WPS超级会员季卡","goodsprice":"63.6500","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":198},{"goodsid":4358,"imgurl":"","goodsname":"Keep会员卡-年卡","goodsprice":"156.2400","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305},{"goodsid":4103,"imgurl":"","goodsname":"WPS超级会员月卡","goodsprice":"29.0000","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":198},{"goodsid":4104,"imgurl":"","goodsname":"WPS普通会员年卡","goodsprice":"86.8800","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":199},{"goodsid":4105,"imgurl":"","goodsname":"WPS普通会员月卡","goodsprice":"17.7500","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":199},{"goodsid":4106,"imgurl":"","goodsname":"喜马拉雅FM周卡","goodsprice":"7.1500","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":195},{"goodsid":4107,"imgurl":"","goodsname":"凯叔讲故事会员直充年卡","goodsprice":"278.7500","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":195},{"goodsid":4363,"imgurl":"","goodsname":"百度网盘普通会员-月卡","goodsprice":"8.3000","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305},{"goodsid":4108,"imgurl":"","goodsname":"凯叔讲故事会员直充季卡","goodsprice":"78.5000","goodsstatus":1,"goodstype":1,"stock":999999,"buyminnum":1,"goodsgroupid":195},{"goodsid":4364,"imgurl":"","goodsname":"百度网盘普通会员-季卡","goodsprice":"25.8900","goodsstatus":1,"goodstype":1,"stock":9999,"buyminnum":1,"goodsgroupid":305}],"nowpage":"","allpage":0,"count":350}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Integer | 1=成功 其他失败 |
| msg | 查询成功 | String | 描述信息 |
| data | - | - | - |
| data.goodsid | 4352 | Integer | 商品ID |
| data.imgurl | - | String | 商品图标地址 |
| data.goodsname | 454545454545454迅雷超级会员-月卡4545 | String | 商品名称 |
| data.goodsprice | 21.8800 | String | 商品售价 |
| data.goodsstatus | 1 | Integer | 商品状态1=在售 0=下架 |
| data.goodstype | 1 | Integer | 商品类型 0=卡密 1=直冲 |
| data.stock | 111111 | Integer | 商品库存 |
| data.buyminnum | 1 | Integer | 起售数量 |
| data.goodsgroupid | 305 | Integer | 商品分类ID |
| nowpage | - | String | 当前页 |
| allpage | - | Integer | 总页数 |
| count | 350 | Integer | 总数量 |
错误响应示例
javascript
{"code":-1,"msg":"效验sign失败，正确SIGN拼接goodstype=1&userid=1004+key"}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | -1 | Integer | - |
| msg | 效验sign失败，正确SIGN拼接goodstype=1&userid=1004+key | String | - |
/商户对接API/获取所有商品(简易版本)(即将取消,新接口上线后一个月内取消)
text
[签名生成规则](https://console-docs.apipost.cn/preview/064ad24ed549dda7/6276496fb193225a?target_id=f14f6b70-8989-4448-b9fe-f8cc65efbc6e)
限制说明：频率1秒一次，limit最高50条一页(禁止高频繁访问)接口状态
已完成
接口URL
/dockapi/v3/getallgoods
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | String | 是 | 商户ID |
| goodstype | 1 | String | 否 | - |
| goodsgroupid | - | String | 否 | - |
| goodsname | - | String | 否 | - |
| limit | - | String | 否 | - |
| page | - | String | 否 | - |
| sign | de76e075dd7d880d66984a2c9f733238 | String | 是 | 签名生成规则 |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{"code":1,"msg":"查询成功","data":[{"goodsid":4094,"goodsprice":"0.0200","goodsstatus":1,"stock":999999},{"goodsid":4098,"goodsprice":"86.8800","goodsstatus":1,"stock":999999},{"goodsid":4099,"goodsprice":"36.9200","goodsstatus":1,"stock":999999},{"goodsid":4100,"goodsprice":"21.0000","goodsstatus":1,"stock":176},{"goodsid":4101,"goodsprice":"171.4700","goodsstatus":1,"stock":999999},{"goodsid":4102,"goodsprice":"63.6500","goodsstatus":1,"stock":999999},{"goodsid":4103,"goodsprice":"29.0000","goodsstatus":1,"stock":999999},{"goodsid":4104,"goodsprice":"86.8800","goodsstatus":1,"stock":999999},{"goodsid":4105,"goodsprice":"17.7500","goodsstatus":1,"stock":999999},{"goodsid":4106,"goodsprice":"7.1500","goodsstatus":1,"stock":999999}],"nowpage":1,"allpage":36,"count":357}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Integer | 1=成功 其他失败 |
| msg | 查询成功 | String | 描述信息 |
| data | - | - | - |
| data.goodsid | 4094 | Integer | 商品ID |
| data.goodsprice | 0.0200 | String | 商品售价 |
| data.goodsstatus | 1 | Integer | 商品状态1=在售 0=下架 |
| data.stock | 999999 | Integer | 商品库存 |
| nowpage | 1 | Integer | 当前页 |
| allpage | 36 | Integer | 总页数 |
| count | 357 | Integer | 总数量 |
错误响应示例
javascript
{"code":-1,"msg":"效验sign失败，正确SIGN拼接goodstype=1&userid=1004+key"}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | -1 | Integer | - |
| msg | 效验sign失败，正确SIGN拼接goodstype=1&userid=1004+key | String | - |
/商户对接API/获取商品详情(即将取消,新接口上线后一个月内取消)
text
限制说明：1分钟内不能超过60次接口状态
已完成
接口URL
/dockapi/v2/goodsdetails.html
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | String | 是 | - |
| goodsid | 4352 | String | 是 | - |
| sign | a2a40ed3e7e53e5de1166b4a9d1ae562 | String | 是 | - |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{"code":1,"msg":"查询成功","goodsdetails":{"id":4352,"groupname":"生活服务","groupimgurl":"","brandname":"","brandimgurl":"","brandid":0,"attachgroupid":116,"goodsname":"454545454545454迅雷超级会员-月卡4545","goodsgroupid":305,"stock":111111,"salesvolume":9,"goodsprice":21.88,"marketprice":0,"goodsstatus":1,"buyminnum":1,"buymaxnum":50000,"tiptext":"下单支持绑定的迅雷的手机号，或者邮箱， 请不要填写错误，填写错误无法退款","imgurl":"","goodstype":1,"goodstypetext":"","msgboxtip":"","details":"<p>下单支持绑定的迅雷的手机号，或者邮箱，\n\n请不要填写错误，填写错误无法退款<\/p>","attach":[{"title":"账号","tip":"QQ号\/手机号"}]}}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Integer | 1=成功 其他等于失败 |
| msg | 查询成功 | String | 提示信息 |
| goodsdetails | - | - | 商品详情 |
| goodsdetails.id | 4352 | Integer | 商品ID |
| goodsdetails.groupname | 生活服务 | String | 商品分组名称 |
| goodsdetails.groupimgurl | - | String | 商品分组图标 |
| goodsdetails.brandname | - | String | 关联品牌名称 |
| goodsdetails.brandimgurl | - | String | 品牌图标 |
| goodsdetails.brandid | - | Integer | 品牌ID |
| goodsdetails.attachgroupid | 116 | Integer | 充值字段模版ID |
| goodsdetails.goodsname | 454545454545454迅雷超级会员-月卡4545 | String | 商品名称 |
| goodsdetails.goodsgroupid | 305 | Integer | 商品分组ID |
| goodsdetails.stock | 111111 | Integer | 库存 |
| goodsdetails.salesvolume | 9 | Integer | 销量 |
| goodsdetails.goodsprice | 21.88 | Number | 价格 |
| goodsdetails.marketprice | - | Integer | 市场价格 |
| goodsdetails.goodsstatus | 1 | Integer | 商品状态 1=正常 0=下架 |
| goodsdetails.buyminnum | 1 | Integer | 起购数量 |
| goodsdetails.buymaxnum | 50000 | Integer | 单次限购数量 |
| goodsdetails.tiptext | 下单支持绑定的迅雷的手机号，或者邮箱， 请不要填写错误，填写错误无法退款 | String | 提示信息 |
| goodsdetails.imgurl | - | String | 商品图标 |
| goodsdetails.goodstype | 1 | Integer | 商品类型1=代充 0=卡密 |
| goodsdetails.goodstypetext | - | String | - |
| goodsdetails.msgboxtip | - | String | 弹窗提示 |
| goodsdetails.details | 下单支持绑定的迅雷的手机号，或者邮箱，请不要填写错误，填写错误无法退款 | String | 商品详情 |
| goodsdetails.attach | - | - | 商品充值字段 |
| goodsdetails.attach.title | 账号 | String | 充值字段标题 |
| goodsdetails.attach.tip | QQ号/手机号 | String | 充值字段提示 |
/商户对接API/获取商品详情(简易版本)(即将取消,新接口上线后一个月内取消)
text
限制说明：1分钟内不能超过120次接口状态
已完成
接口URL
/dockapi/v3/goodsdetails.html
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | String | 是 | - |
| goodsid | 4352 | String | 是 | - |
| sign | a2a40ed3e7e53e5de1166b4a9d1ae562 | String | 是 | - |
认证方式
text
noauth预执行脚本
javascript
暂无预执行脚本后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{"code":1,"msg":"查询成功","goodsdetails":{"stock":111111,"goodsprice":21.88,"goodsstatus":1}}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Integer | 1=成功 其他等于失败 |
| msg | 查询成功 | String | 提示信息 |
| goodsdetails | - | - | - |
| goodsdetails.stock | 111111 | Integer | 库存 |
| goodsdetails.goodsprice | 21.88 | Number | 价格 |
| goodsdetails.goodsstatus | 1 | Integer | 商品状态 1=正常 0=下架 |
/商户对接API/生成兑换码
text
接口生成兑换卡密不消费余额，卡密使用才消费余额，一个商户总共未使用的卡密不能超过1000个，超过1000个就生成不了了接口状态
已完成
接口URL
/dockapi/v2/addexchangecardno
请求方式
POST
Content-Type
urlencoded
请求Body参数
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| userid | 1004 | - | 是 | 商户ID |
| goodsid | 4098 | - | 是 | 商品ID |
| sign | c7418da37406d66c948b6ea56adb7fb9 | - | 是 | 签名sign,详见签名规则 |
| endtime | - | - | 否 | 兑换码过期时间，单位天，默认7天 |
| maxmoney | 12.2 | - | 否 | 进货价格大于设置的maxmony,卡密失效，预防亏本 |
| createnum | 1 | String | 否 | 生成数量，默认每次生成1张 |
| maxmoney | 成本价格 | String | 否 | 成本价格超过这个价格卡密失效，推荐推荐出售价格 |
| outorderno | 2013011121541254111 | String | 否 | 商户自传订单号，使用场景，用于记录电商订单号等 |
| sellmoney | 10 | String | 否 | 出售金额，用于统计利润 |
认证方式
text
noauth预执行脚本
javascript
apt.globals.set("userid", "1004");
apt.globals.set("goodsid", "4098");
apt.globals.set("endtime", "7");
apt.globals.set("maxmoney", "1000");
apt.globals.set("outorderno", "20230105");
apt.globals.set("sign", CryptoJS.MD5('endtime='+apt.globals.get("endtime")+'&goodsid='+apt.globals.get("goodsid")+'&maxmoney='+apt.globals.get("maxmoney")+apt.globals.get("outorderno")+'&userid='+apt.globals.get("userid")+'995f731ba29dc9ffece09e4c346e3900').toString());
console.log(apt.globals.get("sign"));后执行脚本
javascript
暂无后执行脚本成功响应示例
javascript
{
"code": 1,
"msg": "兑换卡密添加成功",
"data": {
"cardno": "JdsOwynzxbiSzQuXXdgF",
"cardnoData": [
"JdsOwynzxbiSzQuXXdgF"
],
"cardnourl": "http://www.cdk.com/cdk.html?goodsid=4098&exchangecardno=JdsOwynzxbiSzQuXXdgF",
"cardnourlData": [
"http://www.cdk.com/cdk.html?goodsid=4098&exchangecardno=JdsOwynzxbiSzQuXXdgF"
]
}
}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | 1 | Number | - |
| msg | 兑换卡密添加成功 | String | 返回文字描述 |
| data | - | Object | 返回数据 |
| data.cardno | JdsOwynzxbiSzQuXXdgF | String | 单独卡密 |
| data.cardnoData | JdsOwynzxbiSzQuXXdgF | String | 单独卡密数组 |
| data.cardnourl | http://www.cdk.com/cdk.html?goodsid=4098&exchangecardno=JdsOwynzxbiSzQuXXdgF | String | 带链接可以直接打开兑换 |
| data.cardnourlData | http://www.cdk.com/cdk.html?goodsid=4098&exchangecardno=JdsOwynzxbiSzQuXXdgF | String | 带链接数组可以直接打开兑换 |
错误响应示例
javascript
{"code":-1,"msg":"效验sign失败，正确SIGN拼接endtime=10080&goodsid=4098&maxmoney=1000&userid=1004+key"}| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| code | -1 | Number | - |
| msg | 效验sign失败，正确SIGN拼接endtime=10080&goodsid=4098&maxmoney=1000&userid=1004+key | String | 返回文字描述 |