放平台中心介绍
API接口规则
商品API
交易API
开放平台中心介绍
开放平台中心是用于和第三方电子商务平台实现资源共享和互通的平台,将各个电子商务平台的商品进行资源整合、筛选,实现双方共赢,并且最终的目的是将最优质、最可靠、最低价的商品提供给终端购买用户。
商品进货中心:只需您在本平台注册账号,向管理员申请API进货权限,即可将本平台的商品对接到自己的电子商户平台上进行销售,不再为商品的货源而烦恼。
嗨游开放平台优势
资源优质
专业质检严格把控产品质量,精选优质商品
平台稳定
专业技术团队及运营商务团队深切配合,快速处理问题
操作便捷
快速便捷的接入流程,支持多场景合作和定制化
API方法调用介绍
通过HTTP请求,将API方法需要的参数采用post方式提交到本平台
提交的url接口地址为:https://www.hiyoo.com/open/apiopen/apiOpenMethod.aspx
所有参数必须通过URL编码,编码格式为:UTF8
API参数
调用API方法,须传入系统参数和应用参数。系统参数必须传入;应用参数根据不同API方法具体传入
1、系统参数
名称
类型
描述
Method
string
API方法名称
CustomerID
int
账户编号
Sign
string
签名验证串
2、应用参数
参照具体API方法定义的参数
3、签名验证串Sign形成规则
所有参数按照参数名字母升序排列组合,最后链接上签名密钥key进行md5加密,md5加密编码格式为gb2312,参数值是未经过url编码
例如调用接口:SaleOrder.InterfaceOrder,客户账户编号CustomerID=10000,Status=0,key=sdk23sdjfer23423
待加密原文串为:CustomerID=10000&Method=SaleOrder.InterfaceOrder&Status=0&key=sdk23sdjfer23423
商品购买
商品参数
商品购买
Product.ApiBuy 提供了商品购买
应用级输入参数
收起
名称
类型
是否必须
描述
ProductID
int
商品编号
BuyNum
int
购买数量
Account
string
充值账号
Account1
string
充值账号1
AccountPassword
string
充值账号密码
ChargeWay
string
充值方式
AccountType
string
账号类型
Game
string
充值游戏
Zone
String
充值游戏区域
ZoneValue
string
充值游戏区域编号
Server
string
充值服务器
ServerValue
string
充值游戏服务器编号
Para1
string
充值选项1
Para2
string
充值选项2
Para3
string
充值选项3
Para4
string
充值选项4
Para5
string
充值选项5
Para6
string
充值选项6
OrderNo
string
第三方平台订单号
ReturnUrl
string
订单交易完成回调地址
CustomerIp
string
购买者ip地址
CustomerSalePrice
string
第三方平台销售给客户的销售单价
返回结果
收起
名称
类型
描述
Code
bool
充值请求结果
success-请求成功(查看Data表里订单结果信息),fail-请求失败
Msg
string
接口处理返回信息
iOrderStatus
int
充值结果状态(Data表)
-1:订单交易失败;0:订单交易中;1:订单交易成功;2:订单交易可疑;3:订单交易处理中
SaleOrderNo
string
平台订单号(Data表)
注释
1、Code=fail时,无Data表数据,充值作失败处理
2、Code=success时,查看Data表中iOrderStatus字段值,-1:交易失败,无异步通知结果;1:交易成功,无异步通知结果;其它值:交易处理中,等待系统异步通知结果
订单充值结果回调
交易查询
订单充值结果回调
提供了充值中的订单充值完成后将订单状态异步通知给api接口用户
应用级输入参数
收起
名称
类型
是否必须
描述
返回结果
收起
名称
类型
描述
OrderNo
string
接口用户的系统订单号
OrderStatus
int
订单充值结果,1:充值成功;-1:充值失败
OrderMessage
string
订单充值结果信息
sign
string
签名验证串
注释
1、OrderNo、OrderStatus、OrderMessage,均采用了base64加密(编码格式为gb2312),值获取后先将空格转换为+,再base64解密
2、sign签名规则,采用md5加密(编码格式为gb2312),待加密字符串:OrderMessage=***&OrderNo=***&OrderStatus=***&key=***