CA状态查询
更新时间：2026-06-25
CA 状态查询
接口描述
本接口用于查询用户 CA 申请状态和证书信息。调用方可通过用户地址查询最近一次 CA 申请记录，也可传入 CA 申请编号查询指定申请。
请求结构
Plain Text
1POST /saas/openapi/econtract/v1/ca/status HTTP/1.1
2Host: xuper.baidu.com
3Content-Type: application/json;charset=utf-8
4X_BXEO_APP_ID: ak string
5X_BXEO_NONCE: nonce string
6X_BXEO_SIGN: sign string
7X_BXEO_TIMESTAMP: new time string
8X_BXEO_CONTENTMD5: body md5 string
9X_BXEO_SIGNTYPE: HMAC-SHA256请求头域
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| X_BXEO_APP_ID | string | 是 | 应用 AK |
| X_BXEO_NONCE | string | 是 | 请求随机串，同一应用下不可重复 |
| X_BXEO_SIGN | string | 是 | 请求签名 |
| X_BXEO_TIMESTAMP | string | 是 | 请求时间戳 |
| X_BXEO_CONTENTMD5 | string | 是 | 请求业务参数摘要 |
| X_BXEO_SIGNTYPE | string | 是 | 签名算法，固定为 HMAC-SHA256 |
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| bxeoContent | object | 是 | RequestBody参数 | body 共用字段头 |
| +address | string | 是 | RequestBody参数 | BEXO 系统中用户唯一身份标识 |
| +user_type | int | 否 | RequestBody参数 | CA 类型，1：个人 CA，2：企业 CA；不传时按账号类型判断 |
响应头域
无特殊响应头域。
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码，0 为成功 |
| msg | string | 错误信息 |
| data | object | 接口返回的具体业务信息 |
| +apply_status | int | CA 申请状态，0：申请中/待认证，1：申请成功，2：申请失败，3：无申请记录或记录已失效 |
| +cert_state | string | CA 证书状态 |
| +h5_url | string | CA 认证链接 |
| +cert_id | string | CA 证书 ID |
| +valid_end_time | int | CA 证书有效期截止时间 |
请求示例
Plain Text
1POST /saas/openapi/econtract/v1/ca/status HTTP/1.1
2Host: xuper.baidu.com
3Content-Type: application/json;charset=utf-8
4X_BXEO_APP_ID: lf2a69d4dff7dc9f3a462719da8bb942
5X_BXEO_NONCE: 12333312112
6X_BXEO_SIGN: sign string
7X_BXEO_TIMESTAMP: 1660733105
8X_BXEO_CONTENTMD5: body md5 string
9X_BXEO_SIGNTYPE: HMAC-SHA256
10
11{
12 "bxeoContent": {
13 "address": "k76SabZ76qi9fU9KyX2iFcG89mHNpWeJ8",
14 "user_type": 1,
15 "ca_code": "CA202606170001"
16 }
17}响应示例
JSON
1{
2 "code": 0,
3 "msg": "success",
4 "data": {
5 "apply_status": 1,
6 "cert_state": "OVER",
7 "h5_url": "https://example.com/ca/auth",
8 "cert_id": "CERT202606170001",
9 "valid_end_time": 1875260000
10 }
11}评价此篇文章