通用RPC接口

API RPC端点

POST /rpc

支持的方法

• cus-sec_SpcGetCertNo - 获取证书编号（无需参数）
• cus-sec_SpcGetEntName - 获取企业名称（无需参数）
• cus-sec_SpcGetEnvCertAsPEM - 获取信封证书为 PEM 格式
• cus-sec_SpcGetSignCertAsPEM - 获取签名证书为 PEM 格式
• cus-sec_SpcSHA1DigestAsPEM - 计算 SHA1 摘要（需要 szInfo）
• cus-sec_SpcSignDataAsPEM - 带哈希签名数据（需要 inData）
• cus-sec_SpcSignDataNoHashAsPEM - 不带哈希签名数据（需要 inData）

请求格式

无参数方法

{
  "_method": "cus-sec_SpcGetCertNo"
}

有参数方法

{
  "_method": "cus-sec_SpcSignDataAsPEM",
  "args": {
    "inData": "Hello World"
  }
}

注意

• passwd 字段会从配置中自动注入，客户端不应发送
• 对于不需要参数的方法，可以省略 args 字段

响应格式

成功响应

{
  "_method": "cus-sec_SpcGetCertNo",
  "_status": "00",
  "_args": {
    "Result": true,
    "Data": [
      "0177f045"
    ],
    "Error": []
  }
}

错误响应

{
  "_method": "cus-sec_SpcSignDataAsPEM",
  "_status": "00",
  "_args": {
    "Result": false, 
    "Data": [],
    "Error": [ 
      "参数检查失败,传入的args中必须包含必要的非空白参数:inData",
      "Err:Base50000"
    ]
  }
}

提示

_status 字段表示 协议状态（"00" = 成功），而 _args.Result 表示 UKey操作 是否成功。

示例 API 调用

获取企业名称：

curl -H "Content-Type: application/json" \
  -d '{"_method":"cus-sec_SpcGetEntName"}' \
  http://127.0.0.1:8780/rpc

获取证书编号：

curl -H "Content-Type: application/json" \
  -d '{"_method":"cus-sec_SpcGetCertNo"}' \
  http://127.0.0.1:8780/rpc

签名数据：

curl -H "Content-Type: application/json" \
  -d '{"_method":"cus-sec_SpcSignDataAsPEM","args":{"inData":"Hello World"}}' \
  http://127.0.0.1:8780/rpc