请求地址:https://www.oquan.cc/api/api/get_user_info.html
请求类型:GET或者POST
请求参数:
参数名 | 参数类型 | 长度 | 是否必须 | 说明 |
---|---|---|---|---|
user | int | 随机 | 是 | 商户ID号 |
time | int | 时间戳 | 是 | 必须是当前时间戳。 |
sign | 字符串 | 32字符 | 是 | 根据请求信息生成的签名 |
sign签名算法:md5(当前时间戳|用户ID|用户的APIkey);
请求样例:
例1:https://www.oquan.cc/api/api/get_user_info.html?time=1655314593&user=1&sign=*****生成的32位签名*****
例2:https://www.oquan.cc/api/api/get_user_info/time/1655314593/user/1/sign/*****生成的32位签名*****
返回参数:
参数名 | 说明 |
---|---|
code | 接口状态码。除200外其他都是错误代码 |
msg | 接口返回的消息 |
balance | 用户余额 |
frozen | 冻结金额 |
返回样例:
{
"code":200,
"msg":"查询成功",
"balance":"0.9900",
"frozen":"0.2000"
}
请求地址:https://www.oquan.cc/api/api/get_item_list.html
请求类型:GET或者POST
请求参数:
参数名 | 参数类型 | 长度 | 是否必须 | 说明 |
---|---|---|---|---|
user | int | 随机 | 是 | 商户ID号 |
time | int | 时间戳 | 是 | 必须是当前时间戳。 |
sign | 字符串 | 32字符 | 是 | 根据请求信息生成的签名 |
sign签名算法:md5(当前时间戳|用户ID|用户的APIkey);
请求样例:
例1:https://www.oquan.cc/api/api/get_item_list.html?time=1655314593&user=1&sign=*****生成的32位签名*****
例2:https://www.oquan.cc/api/api/get_item_list/time/1655314593/user/1/sign/*****生成的32位签名*****
返回参数:
参数名 | 说明 |
---|---|
code | 接口状态码。除200外其他都是错误代码 |
msg | 接口返回的消息 |
data.item | 商品编码 |
data.title | 商品标题 |
data.pic | 图片地址 |
data.number | 库存数量 |
data.price | 售价 |
data.limit_price | 终端限价 |
data.official_price | 官网价 |
返回样例:
{
"code":200,
"msg":"查询成功",
"data":[
{
"id":商品ID(此参数无用,后期取消),
"item":本站商品编码,
"title":商品标题,
"pic":图片;,
"number":库存数量,
"price":售价,
"limit_price":"终端限价,不限价就返回0",
"official_price":"官网价"
},
{
"id":商品ID(此参数无用,后期取消),
"item":本站商品编码,
"title":商品标题,
"pic":图片;,
"number":库存数量,
"price":售价,
"limit_price":"终端限价,不限价就返回0",
"official_price":"官网价"
}
}
请求地址:https://www.oquan.cc/api/api/get_item_info.html
请求类型:GET或者POST
请求参数:
参数名 | 参数类型 | 长度 | 是否必须 | 说明 |
---|---|---|---|---|
code | 字符串 | 随机 | 是 | 商品的编码,商品详情页可见 |
limit | 浮点数 | 随机 | 否 | 安全限价,比如0.1,将获取售价小于0.1的商品数量和价格,此参数为0或不传递,则根据本站最新定价获取库存 |
self | int | 0或1 | 否 | self=1只获取自己上传的库存,不是的话可以不提交此参数 |
user | int | 随机 | 是 | 商户ID号 |
time | int | 时间戳 | 是 | 必须是当前时间戳 |
sign | 字符串 | 32字符 | 是 | 根据请求信息生成的签名 |
sign签名算法:md5(商品编码|当前时间戳|用户ID|用户的APIkey);
请求样例:
例1:https://www.oquan.cc/api/api/get_item_info.html?code=qingjiediandanche&limit=0.9&self=1&time=1655314593&user=1&sign=*****生成的32位签名*****
例2:https://www.oquan.cc/api/api/get_item_info.html?code=qingjiediandanche&limit=0.9&time=1655314593&user=1&sign=*****生成的32位签名*****
返回参数:
参数名 | 说明 |
---|---|
code | 接口状态码。除200外其他都是错误代码 |
msg | 接口返回的消息 |
id | 商品ID,此参数没用,暂时保留 |
title | 商品名称 |
price | 商品售价,如果self=1是自己的库存可以放心,不扣费 |
prices | 如果商品有多个价格则返回此参数 |
prices.price | 商品售价 |
prices.num | 此价格的商品数量 |
limit_price | 商品终端限价 |
official_price | 商品面值 |
number | 商品数量,如果self=1是自己的库存数量,否则返回全部低于limit的数量 |
buy_number | 直充商品单次最大允许购买数量 |
返回样例:
{
"code":200,
"msg":"查询成功",
"id":999,
"title":"测试商品",
"price":0.21,
"prices":[
{
"price":0.21,
"num":1,
},
{
"price":0.22,
"num":1,
}
]
"number":99,
"buy_number":1
}
请求地址:https://www.oquan.cc/api/api/buy.html
请求类型:GET或者POST
请求参数:
参数名 | 参数类型 | 长度 | 是否必须 | 说明 |
---|---|---|---|---|
account | 字符串 | 随机 | 否 | 充值账号,如果是提取卡密的订单,请不要附带这个参数,否则提货失败。充值订单一次只能购买一件 |
black | 整型 | 0或1 | 否 | 只对直冲订单生效。1为开启充值黑名单拦截,0则不拦截。不传递此参数不开启拦截 |
code | 字符串 | 随机 | 是 | 商品的编码,商品详情页可见 |
limit | 浮点数 | 随机 | 否 | 安全限价,比如0.1,将获取售价小于0.1的商品数量和价格,此参数为0或不传递,则根据本站最新定价创建订单.建议传递此参数,否则盈亏自负。 |
num | int | 随机 | 是 | 购买数量,如果是充值订单这里只能是1 |
order | 字符串 | 32字符内 | 是 | 外部订单号,必须确保唯一性,否则引起创建订单失败 |
self | int | 0或1 | 否 | self=1只获取自己上传的库存,不是的话可以不提交此参数 |
user | int | 不限制 | 是 | 商户ID号 |
time | int | 时间戳 | 是 | 必须是当前时间戳。 |
sign | 字符串 | 32字符 | 是 | 根据请求信息生成的签名 |
sign签名算法:md5(code|商品编码;num|购买数量;order|外部订单号;key|用户的APIkey;time|当前时间戳;user|用户ID);
卡密-请求样例:
例1:https://www.oquan.cc/api/api/buy.html?code=qingjiediandanche&limit=0.9&num=100&order=1a2b3c4d5e&self=1&time=1655314593&user=1&sign=*****生成的32位签名*****
例2:https://www.oquan.cc/api/api/buy.html?code=qingjiediandanche&limit=0.9&num=100&order=1a2b3c4d5e&time=1655314593&user=1&sign=*****生成的32位签名*****
充值-请求样例:
例1:https://www.oquan.cc/api/api/buy.html?account=13800000000&code=qingjiediandanche&limit=0.9&num=1&order=1a2b3c4d5e&time=1655314593&user=1&sign=*****生成的32位签名*****
返回参数:
参数名 | 说明 |
---|---|
code | 接口状态码。200下单成功,201订单已经存在。其他都是下单失败 |
msg | 接口返回的消息 |
data | 保存订单信息的数组 |
data|cardlist.key | 本站的订单唯一标识.(本站订单号) |
data|cardlist.price | 该订单的价格 |
data|cardlist.QrcodeImgid | 二维码地址,如果是充值订单不返回该参数 |
data|cardlist.QrcodeImginfo | 二维码的解析内容,如果是充值订单不返回该参数 |
data|cardlist.Cardno | 卡号,如果是充值订单不返回该参数,如果是链接兑换类商品,这里返回的时兑换码 |
data|cardlist.Cardpwd | 卡密,如果是充值订单不返回该参数,如果是链接兑换类商品,这里返回的时兑换链接 |
data|cardlist.infoMsg | 无用的参数,如果是充值订单不返回该参数 |
data|cardlist.status | 订单状态:-1:充值失败, 0:待充值(卡密类则为待过期), 1:锁定, 2:充值成功或卡密已经过了质保期, 3:纠纷, 4:充值中 |
data|cardlist.url | 该订单的查看或充值地址,可访问这个链接查看卡密或充值 |
卡密返回样例:
{
"num":2,
"code":200,
"msg":"提货成功",
"cardlist":[
{
"QrcodeImgid":图片链接,
"QrcodeImginfo":二维码的解析内容,
"Cardno":卡号1或兑换码1,
"Cardpwd":"卡密1或兑换链接1",
"infoMsg":null,
"price":0.11,
"key":"md5值",
"url":"https:\/\/www.oquan.cc\/key\/md5值.html"
},
{
"QrcodeImgid":图片链接,
"QrcodeImginfo":二维码的解析内容,
"Cardno":卡号2或兑换链接2,
"Cardpwd":"卡密2或对联链接2",
"infoMsg":null,
"price":0.21,
"key":"md5值",
"url":"https:\/\/www.oquan.cc\/key\/md5值.html"
}
]
}
充值返回样例:
{
"num":1,
"code":200,
"msg":"开始充值",
"data":[
{
"key":"md5值",
"price":0.51;,
"status":0,
"url":"https:\/\/www.oquan.cc\/key\/md5值.html"
}
]
}
请求地址:https://www.oquan.cc/api/api/get_order_info.html
请求类型:GET或者POST
请求参数:
参数名 | 参数类型 | 长度 | 是否必须 | 说明 |
---|---|---|---|---|
order | 字符串 | 100字符内 | 是 | 本站订单唯一标识key |
user | int | 随机 | 是 | 商户ID号 |
签名算法:该接口无需计算签名
请求样例:
例1:https://www.oquan.cc/api/api/get_order_info.html?user=1&order=*****本站接口返回的订单唯一标识key*****
返回参数:
参数名 | 说明 |
---|---|
code | 接口状态码。除200外其他都是错误代码 |
msg | 接口返回的消息 |
key | 本站的订单唯一标识 |
price | 该订单的价格 |
QrcodeImgid | 二维码地址,如果是充值订单不返回该参数 |
QrcodeImginfo | 二维码的解析内容,如果是充值订单不返回该参数 |
Cardno | 卡号,如果是充值订单不返回该参数,如果是链接兑换类商品,这里返回的时兑换码 |
Cardpwd | 卡密,如果是充值订单不返回该参数,如果是链接兑换类商品,这里返回的时兑换链接 |
infoMsg | 无用的参数,如果是充值订单不返回该参数 |
status | 订单状态:-1:充值失败, 0:待充值(卡密类则为待过期), 1:锁定, 2:充值成功或已经过了质保期, 3:纠纷, 4:充值中 |
url | 该订单的查看或充值地址,可访问这个链接查看卡密或充值 |
返回样例:
{
"key":"md5值",
"price":"0.02",
"QrcodeImgid":null,
"QrcodeImginfo":null,
"Cardno":null,
"Cardpwd":null,
"infoMsg":null,
"status":2,
"url":"https:\/\/www.oquan.cc\/key\/md5值.html",
"code":200,
"msg":"查询成功"
}
请求地址:https://www.oquan.cc/api/api/get_outorder_info.html
请求类型:GET或者POST
请求参数:
参数名 | 参数类型 | 长度 | 是否必须 | 说明 |
---|---|---|---|---|
order | 字符串 | 32字符内 | 是 | 外部订单号 |
user | int | 随机 | 是 | 商户ID号 |
签名算法:该接口无需计算签名
请求样例:
例1:https://www.oquan.cc/api/api/get_outorder_info.html?user=1&order=*****外部订单号,可以是你网站生成的订单号*****
返回参数:
参数名 | 说明 |
---|---|
code | 接口状态码。200下单成功,201订单已经存在。其他都是下单失败 |
msg | 接口返回的消息 |
data | 保存订单信息的数组 |
data.key | 本站的订单唯一标识 |
data.price | 该订单的价格 |
data.QrcodeImgid | 二维码地址,如果是充值订单不返回该参数 |
data.QrcodeImginfo | 二维码的解析内容,如果是充值订单不返回该参数 |
data.Cardno | 卡号,如果是充值订单不返回该参数,如果是链接兑换类商品,这里返回的时兑换码 |
data.Cardpwd | 卡密,如果是充值订单不返回该参数,如果是链接兑换类商品,这里返回的时兑换链接 |
data.infoMsg | 无用的参数,如果是充值订单不返回该参数 |
data.status | 订单状态:-1:充值失败, 0:待充值(卡密类则为待过期), 1:锁定, 2:充值成功或已经过了质保期, 3:纠纷, 4:充值中 |
data.url | 该订单的查看或充值地址,可访问这个链接查看卡密或充值 |
返回样例:
{
"code":200,
"msg":"查询成功!",
"data":[
{
"key":"md5值",
"price":"0.11",
"QrcodeImgid":二维码地址,
"QrcodeImginfo":二维码解析内容,
"Cardno":卡号1或兑换码1,
"Cardpwd":"卡密1或兑换链接1",
"infoMsg":null,
"status":0,
"url":"https:\/\/www.oquan.cc\/key\/md5值.html"
},
{
"key":"md5值",
"price":"0.21",
"QrcodeImgid":二维码地址,
"QrcodeImginfo":二维码解析内容,
"Cardno":卡号2或兑换码2,
"Cardpwd":"卡密2或兑换链接2",
"infoMsg":null,
"status":0,
"url":"https:\/\/www.oquan.cc\/key\/md5值.html"
}
]
}