请求¶
访问保全网的API需要使用https协议,并进行数字签名。
路径¶
API地址:https://api.baoquan.com/api/v3
请求路径=API地址+接口名称,比如保全接口的名称是/attestations,则请求路径为 https://api.baoquan.com/api/v3/attestations
方法¶
所有的请求均为HTTP POST方法
参数¶
请求参数¶
字段名 |
描述 |
|---|---|
request_id |
请求号,由接入客户创建唯一字符串,长度不超过32位 |
access_key |
访问识别码,当您在保全网成功上传RSA公钥后会获得一个access_key |
tonce |
请求时间, 必须以 Unix Time 的格式发送, tonce与服务器时间不得超过正负300秒,否则请求将视为无效 |
payload |
被签名的数据体部分,用JSON进行编码,不同的请求的payload数据一般不同 详情请看详细接口介绍 |
signature |
使用你的RSA私钥进行签名后的字符串,具体签名的方法后面会进一步描述 |
请求格式:form-data
应答参数¶
字段名 |
描述 |
|---|---|
flag |
请求标识 |
data |
返回数据 |
errorMessage |
错误描述 |
statusCode |
状态码 |
例如:
{ {
"data": {
"no": "rBgGqKQ1ruCKhXiTgZ2oVr",
},
"errorMessage": "string",
"flag": true,
"statusCode": "string"
}
}
错误码¶
错误码 |
描述 |
|---|---|
500000 |
系统内部错误 |
500001 |
不合法或不正确的参数 |
500002 |
解密出错 |
500003 |
非法公钥文件 |
500004 |
非法私钥文件 |
500010 |
模板不存在 |
500011 |
模板类型与业务不匹配 |
500012 |
业务流水不唯一 |
500013 |
未查询到accesskey信息 |
500014 |
验签失败 |
500017 |
非法时间戳,与当前时间误差较大 |
500018 |
身份标识有误 |
500019 |
文件路径创建失败 |
500020 |
存证文件保存失败 |
500021 |
存证文件hash失败 |
500022 |
未查询到相关存证信息 |
500024 |
未查询到网页存证记录 |
500025 |
访问频率超过限制! |
500026 |
未查询到相关存证信息(未发起过网页截图调用)! |
500027 |
图片下载失败 |
500028 |
取证ID或类型为空! |
500029 |
回调地址为空! |
500030 |
取证结束出现异常,请稍候重试!! |
500031 |
心跳建立失败!! |
500032 |
token已失效!! |
500033 |
此取证正在取证中或已取证完整!! |
500039 |
你有hash存证数据,需上传原文件验证通过后方可出证! |
500040 |
记录不存在! |
500041 |
套餐余量不足! |
500049 |
此网页取证已成功,不用再调用 |
500050 |
此网页取证已失败 |
500051 |
监测接口调用失败 |
500052 |
不需要保全证书 |
500053 |
参数包含引号 |
500054 |
过程取证参数异常 |
500055 |
业务流水不唯一 |