请求

访问保全网的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

业务流水不唯一