请求 ============== 访问保全网的API需要使用https协议,并进行数字签名。 路径 -------------- API地址:`https://api.baoquan.com/api/v3` 请求路径=API地址+接口名称,比如保全接口的名称是/attestations,则请求路径为 `https://api.baoquan.com/api/v3/attestations` 方法 -------------- 所有的请求均为HTTP POST方法 参数 -------------- .. _Unix Time: https://en.wikipedia.org/wiki/Unix_time> 请求参数 ^^^^^^^^^^^^^^^ ================= ================================================================ 字段名 描述 ================= ================================================================ 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 业务流水不唯一 ================= ================================================================