验证时间戳

进行时间戳的验证

一、请求说明

• 请求地址：http://api.spiderid.cn/openapi/tss/v1/tsa/verify,https://api.spiderid.cn/openapi/tss/v1/tsa/verify
• 服务接口名称(即公共参数method的值)： tsa/verify
• 请求方式：POST

TIP

当使用SDK时，请求地址：https://api.spiderid.cn

二、请求参数

名称	类型	是否必须	描述
data	String	否	原文数据
tsa	String	是	时间戳(base64)
dataType	DataType	否	原文数据类型

• DataType 数据类型介绍

字段	类型介绍
BASE64	原文BASE64
HEX	原文Hex
ORIGINAL	原文
DIGEST_BASE64	摘要base64
DIGEST_HEX	摘要16进制HEX

三、响应参数

data 结果信息	类型	描述
verification	Integer	验证结果 0-成功 其他-失败 详见失败信息
message	String	验证失败的描述
signer	String	签发者
signerDn	String	签发证书主题项
genTime	Date	时间戳加盖时间

• verification 返回码介绍

字段	状态码	状态介绍
SUCCESS	0	验证成功
CERT_EXPIRED	1	证书已过期
CERT_INEFFECTIVE	2	证书未生效
CERT_USAGE_DEFICIENCY	3	证书密钥用法错误
CERT_OU_MISMATCHING	4	证书OU项不匹配
CERT_REVOKED	5	证书已注销
CERT_UNTRUSTED	6	证书不可信
SIGN_INVALID	7	数字签名验证不通过

四、成功示例

JSON示例

{
  "code": 0,
  "data": {
    "verification": 0,
    "message": "success",
    "genTime": "2022-03-16T09:21:40.678Z",
    "signer": "string"
  },
  "message": "success",
  "requestId": "xxx"
}

五、失败示例

JSON示例

{
    "code":10100,
    "message":"参数错误",
    "requestId":"62398a2e20c40f25eb02faac"
}

六、SDK请求示例

        // 提供的URL
        String url = "https://api.spiderid.cn";

        // 您的appKey
        String appKey = "XXX";

        // 您的appSecret
        String appSecret = "XXX";

        // 1.原客户端
        PkiClient client = new PkiOkhttpClient(url, appKey, appSecret);

        TssVerifyRequest request = new TssVerifyRequest();
        //原始数据
        request.setData("123");
        //数据类型
        request.setDataType(DataType.ORIGINAL);
        //时间戳(base64)
        request.setTsa("MIIE1TAVAgEAMBAMDk9wZXJ......");
                
        try {
            TssVerifyResponse response = client.execute(request);
            // 后续业务
            if (response.isSuccess()) {
                System.out.println("成功响应：" + response.getBody());
            } else {
                System.out.println("失败响应：" + response.getBody());
            }
        } catch (ApiException e) {
            e.printStackTrace();
        }