开发规范

一、调用介绍

openapi为ratingtoken的数据出口,用户只需要按照规范拼装一个正确的URL,通过https请求,即能获取到所需的数据。

二、调用环境入口

环境入口释义:调用API时,需要传入如下地址,获取相应环境下的数据。

https调用入口地址(即server_url)https://openapi.ratingtoken.io

三、调用参数

调用API时,必须传入对应的应用级参数。各个API的输入参数和返回结果详见API文档。

四、API签名

调用API时需要对请求参数进行签名,服务器端会验证请求参数是否合法。

加密规则

1 在header头中的x-date(GMT格式)及url作为加密字符串
2 使用SHA256算法生成hash值
3 使用base64将hash值转换为signature
签名算法:  
signing_string="x-date: Thu, 22 Jun 2017 17:15:21 GMT\nurl: https://openapi.ratingtoken.io/token/ICORankList?page=2"
digest=HMAC-SHA256(<signing_string>, "secret")
base64_digest=base64(<digest>)
4 连接授权字符串

将下面字符串中用户名及签名结果替换即可

'Authorization: hmac username="用户名", algorithm="hmac-sha256",headers="x-date url",signature="签名结果"'
请求示例
curl -i -X GET https://openapi.ratingtoken.io/token/ICORankList?page=2 \
 -H "X-Date: Thu, 22 Jun 2017 17:15:21 GMT" \
 -H "Url: https://openapi.ratingtoken.io/token/ICORankList?page=2" \
 -H 'Authorization: hmac username="alice123", algorithm="hmac-sha256",headers="x-date url",signature="ujWCGHeec9Xd6UD2zlyxiNMCiXnDOWeVFMu5VeRUxtw="'

results matching ""

    No results matching ""