请求

访问保全网的API需要使用https协议,并进行数字签名。

路径

保全网会提供向后兼容的API,不同的API版本会以比如v2、v2.1这样的字符串标记,当前的版本为v2。

API地址:https://baoquan.com/api/v2

请求路径=API地址+接口名称,比如保全接口的名称是/attestations,则请求路径为 https://baoquan.com/api/v2/attestations

方法

所有的请求均为HTTP POST方法

参数

参数名 描述
request_id 请求号,由接入客户创建唯一字符串,长度不超过32位
access_key 访问识别码,当您在保全网成功上传RSA公钥后会获得一个access_key
tonce 请求时间, 必须以 Unix Time 的格式发送, tonce与服务器时间不得超过正负300秒,否则请求将视为无效
payload 被签名的数据体部分,用JSON进行编码,不同的请求的payload数据一般不同
signature 使用你的RSA私钥进行签名后的字符串,具体签名的方法后面会进一步描述

例如:

{
        "request_id": "2XiTgZ2oVrBgGqKQ1ruCKh",
        "access_key": "2y7cg8kmoGDrDBXJLaizoD",
        "tonce": 1464594744,
        "payload": {
                "template_id": "2hSWTZ4oqVEJKAmK2RiyT4",
        }
        "signature": "moGDrDBXJLaizoD2hSWTZ4oqVEJKAmK2RiyT4"
}