COIN918接口说明
一. 签名认证...................................................................................................................
1.安全认证.................................................................................................................................
2.合法请求结构.........................................................................................................................
3.签名运算.................................................................................................................................
二. 获取价格接口...........................................................................................................
1.基本内容.................................................................................................................................
2.提交参数.................................................................................................................................
3.返回参数.................................................................................................................................
4.返回示例.................................................................................................................................
1.签名认证
1.安全认证:
appid和appsecret可以,需要联系平台(API发放邮箱:server@coin918.pro)
发放。其中,appid为API访问密钥,appsecret为用户对请求进行签名的密钥。
重要提示:这两个密钥与账号安全紧密相关,无论何时都请勿向其它人透露。
2.合法请求结构:
基于安全考虑,API 请求都必须进行签名运算。一个合法的请求由以下几部分组成:
1.api接口请求地址,需要联系平台(API发放邮箱:server@coin918.pro)
2.api访问密钥(appid),管理员发放的appid
3.签名方法用户计算签名的加密方法,统一为sha1
4.必须和可选的参数 每个接口都有一组所需要的必须参数和可选参数
5.签名,签名计算得出的值,用于确保签名有效和未被篡改
例:
http://www.xxxxx.cn/xxx/xxx/get_price?appid=coin918****252&buy_currency=usd&sell_currency=btc&sign=calculated value
3.签名运算
1.按照ASCII码的顺序对参数名进行排序
2.排序过后,将所有参数按照键连接值进行连接,并连接appsecret, 组成最后加密的字符串
3.将字符串进行sha1加密,转换成大写,生成最终签名
例:
1.appid=coin918****252&buy_currency=usd&sell_currency=btc
2.appidcoin918****252buy_currencyusdsell_currencybtc.appsecret
3.sha1(appidcoin918****252buy_currencyusdsell_currencybtc.appsecret)
4.将3步骤中的加密后的字符串,转为全部大写,得到最终签名
2.获取价格接口
1.基本内容
接口地址:http://xxxx/xxx/xxx/get_price
请求类型:GET/POST
接口说明:获取对应币种的当前价格,买一价,卖一价。
2.提交参数
参数 |
是否必填 |
描述 |
buy_currency |
是 |
购买币种,例如usd |
sell_currency |
是 |
出售币种,例如ltc |
appid |
是 |
API密钥 |
sign |
是 |
签名 |
3.返回参数
返回参数 |
描述 |
status |
1:获取成功,0:获取失败 |
err |
status为0时,返回该参数,错误描述 |
data |
status为1时,返回该参数请求数据,new_price:当前价格,buy_price:买一价,sell_price:卖一价 |
4.返回示例
{
"status": 1,
"data": {
"new_price": 57.12,
"buy_price": 57,
"sell_price": 57.12
}
}