Base URLs:

Authentication

SSL证书接口/VSSL Certum API接口

POST 证书产品列表

POST /product/list

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	否	none
body	body	object	否	none

返回示例

200 Response

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "id": 0,
      "name": "string",
      "type": 0,
      "status": 0,
      "money": "string",
      "mark_money": "string",
      "brand": {
        "code": "string",
        "name": "string",
        "image": "string"
      },
      "cert_type": "string",
      "domain_dcv": "string",
      "encryption": "string",
      "hash_sign": "string",
      "key_curve": "string",
      "key_size": "string",
      "sort": 0,
      "create_time": "string",
      "update_time": "string",
      "type_name": "string",
      "brand_name": "string",
      "brand_image": "string"
    }
  ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» id	integer	true	none	none
»» name	string	true	none	none
»» type	integer	true	none	none
»» status	integer	true	none	none
»» money	string	true	none	none
»» mark_money	string	true	none	none
»» brand	object	true	none	none
»»» code	string	true	none	none
»»» name	string	true	none	none
»»» image	string	true	none	none
»» cert_type	string	true	none	none
»» domain_dcv	string	true	none	none
»» encryption	string	true	none	none
»» hash_sign	string	true	none	none
»» key_curve	string	true	none	none
»» key_size	string	true	none	none
»» sort	integer	true	none	none
»» create_time	string	true	none	none
»» update_time	string	true	none	none
»» type_name	string	true	none	none
»» brand_name	string	true	none	none
»» brand_image	string	true	none	none

POST 创建证书订单

POST /product/order

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	否	none
body	body	object	否	none
» product_id	body	string	是	产品ID
» number	body	string	否	多域名必填，域名数量，默认为1

返回示例

200 Response

{
  "code": 0,
  "msg": "string",
  "data": {
    "order_id": "string",
    "product_id": "string",
    "product_uid": "string",
    "user_id": 0,
    "number": "string",
    "amount": "string",
    "payamount": "string",
    "paytype": "string",
    "paytime": 0,
    "method": "string",
    "domain": "string",
    "code": "string",
    "algorithm": 0,
    "cert_type": "string",
    "status": 0,
    "order_status": 0,
    "discount": "string",
    "type": 0,
    "ip": "string",
    "create_time": "string",
    "update_time": "string",
    "id": 0,
    "productData": {
      "id": 0,
      "uid": "string",
      "name": "string",
      "type": 0,
      "status": 0,
      "money": "string",
      "mark_money": "string",
      "brand": "string",
      "cert_type": "string",
      "domain_dcv": "string",
      "encryption": "string",
      "hash_sign": "string",
      "key_curve": "string",
      "key_size": "string",
      "sort": 0,
      "is_delete": 0,
      "create_time": "string",
      "update_time": "string",
      "delete_time": 0,
      "type_name": "string",
      "brand_data": {
        "id": 0,
        "name": "string",
        "code": "string",
        "image": "string",
        "sort": 0,
        "number": 0,
        "days": 0,
        "is_wildcard": 0,
        "is_visible": 0,
        "is_paid": 0,
        "is_delete": 0,
        "create_time": "string",
        "update_time": "string",
        "delete_time": 0
      }
    }
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» order_id	string	true	none	none
»» product_id	string	true	none	none
»» product_uid	string	true	none	none
»» user_id	integer	true	none	none
»» number	string	true	none	none
»» amount	string	true	none	none
»» payamount	string	true	none	none
»» paytype	string	true	none	none
»» paytime	integer	true	none	none
»» method	string	true	none	none
»» domain	string	true	none	none
»» code	string	true	none	none
»» algorithm	integer	true	none	none
»» cert_type	string	true	none	none
»» status	integer	true	none	none
»» order_status	integer	true	none	none
»» discount	string	true	none	none
»» type	integer	true	none	none
»» ip	string	true	none	none
»» create_time	string	true	none	none
»» update_time	string	true	none	none
»» id	integer	true	none	none
»» productData	object	true	none	none
»»» id	integer	true	none	none
»»» uid	string	true	none	none
»»» name	string	true	none	none
»»» type	integer	true	none	none
»»» status	integer	true	none	none
»»» money	string	true	none	none
»»» mark_money	string	true	none	none
»»» brand	string	true	none	none
»»» cert_type	string	true	none	none
»»» domain_dcv	string	true	none	none
»»» encryption	string	true	none	none
»»» hash_sign	string	true	none	none
»»» key_curve	string	true	none	none
»»» key_size	string	true	none	none
»»» sort	integer	true	none	none
»»» is_delete	integer	true	none	none
»»» create_time	string	true	none	none
»»» update_time	string	true	none	none
»»» delete_time	integer	true	none	none
»»» type_name	string	true	none	none
»»» brand_data	object	true	none	none
»»»» id	integer	true	none	none
»»»» name	string	true	none	none
»»»» code	string	true	none	none
»»»» image	string	true	none	none
»»»» sort	integer	true	none	none
»»»» number	integer	true	none	none
»»»» days	integer	true	none	none
»»»» is_wildcard	integer	true	none	none
»»»» is_visible	integer	true	none	none
»»»» is_paid	integer	true	none	none
»»»» is_delete	integer	true	none	none
»»»» create_time	string	true	none	none
»»»» update_time	string	true	none	none
»»»» delete_time	integer	true	none	none

POST 提交域名信息

POST /product/domain

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	否	none
body	body	object	否	none
» order_id	body	string	是	订单ID
» domain	body	string	是	域名信息，请用逗号分割，填写示例：domain.com,domain.cn 。
» dcv_type	body	string	是	域名验证方式，根据产品信息的domain_dcv提供的字段
» encryption	body	string	是	加密算法(RSA/ECC)
» hash_sign	body	string	是	哈希签名算法可选值:(SHA256,SHA384,SHA512)
» key_curve	body	string	否	ECC密钥曲线,仅当encryption为ECC时必传可选值:(P256,P384)
» key_size	body	string	否	加密位数,仅当encryption为RSA时必传可选值:（2048，3072，4096）
» country	body	string	否	国家
» province	body	string	否	省份或州
» locality	body	string	否	城市
» organization	body	string	否	公司名称
» creditCode	body	string	否	组织信用代码
» org_unit	body	string	否	部门
» email	body	string	否	邮箱
» telephone	body	string	否	手机号
» address	body	string	否	公司注册地址
» dateOfIncorporation	body	string	否	注册日期 ,格式必须为 yyyy-mm-dd 如:2006-01-02
» postalCode	body	string	否	邮编
» lastname	body	string	否	姓
» firstname	body	string	否	名
» position	body	string	否	职位

返回示例

200 Response

{
  "code": 0,
  "msg": "string",
  "data": [
    "string"
  ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	[string]	true	none	none

POST 获取订单信息

POST /product/getorder

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	否	none
body	body	object	否	none
» order_id	body	string	否	none

返回示例

200 Response

{
    "code": 0,
    "msg": "获取成功",
    "data": {
        "id": 44,
        "product_id": 18,
        "order_id": "SSLPRO20250810172745409",
        "cert_id": null,
        "user_id": 1,
        "domain": "google.com",
        "code": "Certum",
        "number": 1,
        "domains": "",
        "algorithm": "RSA",
        "cert_type": "dv",
        "status": 2,
        "order_status": 1,
        "type": 4,
        "dcv_type": "dns",
        "dcv_value": [
            {
                "domain": "google.com",
                "value": "168f4128c1d98041353fcae2a8c70e4b2ba770e31f259ac1e50e8240050f149",
                "dcv_type": "dns",
                "type": "TXT",
                "hostname": "@"
            },
            {
                "domain": "www.google.com",
                "value": "168f4128c1d98041353fcae2a8c70e4b2ba770e31f259ac1e50e8240050f149",
                "dcv_type": "dns",
                "type": "TXT",
                "hostname": "@"
            }
        ],
        "is_verified": 0,
        "amount": "18.00",
        "payamount": "18.00",
        "paytype": "balance",
        "paytime": 1754818065,
        "method": "api",
        "ip": "127.0.0.1",
        "cdkey": null,
        "discount": "15.00",
        "renewed": 0,
        "create_time": "2025-08-10 17:27:45",
        "update_time": "2025-08-10 19:54:13",
        "brand": "Certum",
        "brand_img": "http://127.0.0.5/storage/picture/20250808/143607dc28d9f18d16216f08aee08820.png",
        "type_name": "多域名",
        "status_name": "验证中",
        "order_status_name": "申请中",
        "dcv_type_label": "DNS",
        "certData": []
    }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» id	integer	true	none	none
»» product_id	integer	true	none	none
»» order_id	string	true	none	none
»» cert_id	null	true	none	none
»» user_id	integer	true	none	none
»» domain	string	true	none	none
»» code	string	true	none	none
»» number	integer	true	none	none
»» domains	string	true	none	none
»» algorithm	string	true	none	none
»» cert_type	string	true	none	none
»» status	integer	true	none	none
»» order_status	integer	true	none	none
»» type	integer	true	none	none
»» dcv_type	string	true	none	none
»» dcv_value	[object]	true	none	none
»»» domain	string	true	none	none
»»» value	string	true	none	none
»»» dcv_type	string	true	none	none
»»» type	string	true	none	none
»»» hostname	string	true	none	none
»» is_verified	integer	true	none	none
»» amount	string	true	none	none
»» payamount	string	true	none	none
»» paytype	string	true	none	none
»» paytime	integer	true	none	none
»» method	string	true	none	none
»» ip	string	true	none	none
»» cdkey	null	true	none	none
»» discount	string	true	none	none
»» renewed	integer	true	none	none
»» create_time	string	true	none	none
»» update_time	string	true	none	none
»» brand	string	true	none	none
»» brand_img	string	true	none	none
»» type_name	string	true	none	none
»» status_name	string	true	none	none
»» order_status_name	string	true	none	none
»» dcv_type_label	string	true	none	none
»» certData	[string]	true	none	none

POST 修改验证方式

POST /product/dcv

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	否	none
body	body	object	否	none
» order_id	body	string	否	none
» type	body	string	否	none

返回示例

200 Response

{
    "code": 0,
    "msg": "操作成功",
    "data": [
        {
            "domain": "google.com",
            "filefullpath": "/.well-known/pki-validation/certum.txt",
            "filecontent": "5ad79d5a3ae77137bbe8a96e6903188ac470bbea81daecfd00901eb9312a28d-certum.pl",
            "filepath": "/.well-known/pki-validation",
            "filename": "certum.txt",
            "dcv_type": "file",
            "url": "http://google.com/.well-known/pki-validation/certum.txt"
        },
        {
            "domain": "www.google.com",
            "filefullpath": "/.well-known/pki-validation/certum.txt",
            "filecontent": "5ad79d5a3ae77137bbe8a96e6903188ac470bbea81daecfd00901eb9312a28d-certum.pl",
            "filepath": "/.well-known/pki-validation",
            "filename": "certum.txt",
            "dcv_type": "file",
            "url": "http://www.google.com/.well-known/pki-validation/certum.txt"
        }
    ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	[object]	true	none	none
»» domain	string	true	none	none
»» filefullpath	string	true	none	none
»» filecontent	string	true	none	none
»» filepath	string	true	none	none
»» filename	string	true	none	none
»» dcv_type	string	true	none	none
»» url	string	true	none	none

POST 获取验证信息

POST //product/getdcv

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	是	none
body	body	object	否	none
» order_id	body	string	是	none

返回示例

200 Response

{}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

POST 请求验证域名

POST /product/verify

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	是	none
body	body	object	否	none
» order_id	body	string	是	none

返回示例

200 Response

{
    "code": 0,
    "msg": "操作成功",
    "data": []
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	[string]	true	none	none

POST 获取验证状态

POST /product/getstatus

当status=3和order_status=2时证书已签发；
当status=3时：
order_status=5 // OV审核中
order_status=6 // EV审核中

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	是	none
body	body	object	否	none
» order_id	body	string	是	none

返回示例

200 Response

{
    "code": 0,
    "msg": "操作成功",
    "data": {
        "status": 2,
        "orderStatus": 2
    }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» status	integer	true	none	none
»» orderStatus	integer	true	none	none

POST 证书订单退款

POST /product/refund

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	是	none
body	body	object	否	none
» order_id	body	string	否	none

返回示例

200 Response

{
    "code": 0,
    "msg": "操作成功",
    "data": []
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	[string]	true	none	none

POST 重发验证邮件

POST /product/resendemail

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	是	none
body	body	object	否	none
» order_id	body	string	是	none

返回示例

200 Response

{
    "code": 5000,
    "msg": "此品牌不支持邮件重发",
    "data": []
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	[string]	true	none	none

POST 证书重签接口

POST /product/reissue

证书必须已经签发完成，且订单属于当前用户。调用重签接口后，系统会为该订单重新创建一份 CSR，再提交到上游证书供应商进行重签，不会重复使用原有 CSR。

Body 请求参数

请求参数

名称	位置	类型	必选	说明
sign	header	string	是	用户 API Sign；也可以使用现有 API 的 token + terminal 鉴权方式
body	body	object	是	请求体
» order_id	body	string	是*	网站内部证书订单号
» orderNo	body	string	否*	上游订单号；未传 order_id 时可使用
» order_uid	body	string	否*	上游订单号；与 orderNo 二选一，未传 order_id 时可使用
» includeRootDomain	body	string	否	是否包含根域名，可选值：Y、N
» includeWWWDomain	body	string	否	是否包含 www 域名，可选值：Y、N

注：order_id、orderNo、order_uid 至少传一个。优先使用 order_id；如果使用 orderNo 或 order_uid，系统会根据当前用户的订单归属查找对应的本地订单。

返回示例

200 Response

{
  "code": 0,
  "msg": "重签申请已提交",
  "data": {
    "order_id": "SSLPRO20250810172745409",
    "order_uid": "上游订单号",
    "status": 2,
    "order_status": 1,
    "renewed": 1
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	object	true	none	重签提交结果
»» order_id	string	true	none	网站内部订单号
»» order_uid	string	true	none	上游订单号
»» status	integer	true	none	订单状态，`2` 表示重签申请中
»» order_status	integer	true	none	上游订单状态，`1` 表示申请中
»» renewed	integer	true	none	该订单累计重签次数

兼容路径

以下路径与 /product/reissue 执行相同的重签逻辑：

POST /product/renew
POST /certificate/reissue
POST /certificate/renew

重签限制

仅支持已经完成签发的证书订单。

同一订单在重签申请中或未完成新证书签发前，不能重复提交重签。

人工交付、2号供应商和3号供应商订单不调用 VSSL 自动重签接口，需要转人工处理。

重签成功提交后，订单会进入申请中状态；新证书签发完成后，由上游回调更新证书信息和下载地址。

GET 获取用户余额

GET /index/balance

请求参数

名称	位置	类型	必选	说明
sign	header	string	否	none

返回示例

200 Response

{
  "code": 0,
  "msg": "string",
  "data": {
    "balance": "string"
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	说明
» code	integer	true	none	none
» msg	string	true	none	none
» data	object	true	none	none
»» balance	string	true	none	none

完整接口说明

Authentication#

SSL证书接口/VSSL Certum API接口#

POST 证书产品列表#

请求参数#

返回结果#

返回数据结构#

POST 创建证书订单#

请求参数#

返回结果#

返回数据结构#

POST 提交域名信息#

请求参数#

返回结果#

返回数据结构#

POST 获取订单信息#

请求参数#

返回结果#

返回数据结构#

POST 修改验证方式#

请求参数#

返回结果#

返回数据结构#

POST 获取验证信息#

请求参数#

返回结果#

返回数据结构#

POST 请求验证域名#

请求参数#

返回结果#

返回数据结构#

POST 获取验证状态#

请求参数#

返回结果#

返回数据结构#

POST 证书订单退款#

请求参数#

返回结果#

返回数据结构#

POST 重发验证邮件#

请求参数#

返回结果#

返回数据结构#

POST 证书重签接口#

请求参数#

返回结果#

返回数据结构#

兼容路径#

重签限制#

GET 获取用户余额#

请求参数#

返回结果#

返回数据结构#

数据模型#

Authentication

SSL证书接口/VSSL Certum API接口

POST 证书产品列表

请求参数

返回结果

返回数据结构

POST 创建证书订单

请求参数

返回结果

返回数据结构

POST 提交域名信息

请求参数

返回结果

返回数据结构

POST 获取订单信息

请求参数

返回结果

返回数据结构

POST 修改验证方式

请求参数

返回结果

返回数据结构

POST 获取验证信息

请求参数

返回结果

返回数据结构

POST 请求验证域名

请求参数

返回结果

返回数据结构

POST 获取验证状态

请求参数

返回结果

返回数据结构

POST 证书订单退款

请求参数

返回结果

返回数据结构

POST 重发验证邮件

请求参数

返回结果

返回数据结构

POST 证书重签接口

请求参数

返回结果

返回数据结构

兼容路径

重签限制

GET 获取用户余额

请求参数

返回结果

返回数据结构

数据模型