1. 接口描述
接口请求域名： tbaas.tencentcloudapi.com 。
申请用户证书
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：ApplyUserCert。 |
| Version | 是 | String | 公共参数，本接口取值：2018-04-16。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| Module | 是 | String | 模块名，固定字段：cert_mng |
| Operation | 是 | String | 操作名，固定字段：cert_apply_for_user |
| ClusterId | 是 | String | 区块链网络ID，可在区块链网络详情或列表中获取 |
| GroupName | 是 | String | 申请证书的组织名称，可以在组织管理列表中获取当前组织的名称 |
| UserIdentity | 是 | String | 用户证书标识，用于标识用户证书，要求由纯小写字母组成，长度小于10 |
| Applicant | 是 | String | 证书申请实体，使用腾讯云账号实名认证的名称 |
| IdentityNum | 是 | String | 证件号码。如果腾讯云账号对应的实名认证类型为企业认证，填入“0”；如果腾讯云账号对应的实名认证类型为个人认证，填入个人身份证号码 |
| CsrData | 是 | String | csr p10证书文件。需要用户根据文档生成证书的CSR文件 |
| Notes | 否 | String | 证书备注信息 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| CertId | Integer | 证书ID |
| CertDn | String | 证书DN |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 用户证书申请
输入示例
https://tbaas.tencentcloudapi.com/?Action=ApplyUserCert
&Module=cert_mng
&Operation=cert_apply_for_user
&ClusterId=251005746bckuobc41mpu
&GroupName=youtuOrg
&UserIdentity=kyloz
&Applicant=优图SDK
&IdentityNum=123
&CsrData=-----BEGINCERTIFICATEREQUEST-----
MIIBSTCB8AIBADCBjTELMAkGA1UEBhMCQ04xEjAQBgNVBAgMCUd1YW5nWmhvdTER
MA8GA1UEBwwIU2hlblpoZW4xFDASBgNVBAoMC2V4YW1wbGUuY29tMQ8wDQYDVQQL
DAZjbGllbnQxMDAuBgNVBAMMJ0FkbWluLm9yZzJAb3JnMi5leGFtcGxlLmNvbSx0
eXBlPWNsaWVudDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABMIrWeLZjivbTLwy
z+JMfmZjPEJ8x4H8a/CnqBIwcCaJjg5cMqOi+VyFHkCM9Sv4MFOqPAK7rE62m9XF
s4B8hfKgADAKBggqhkjOPQQDAgNIADBFAiEAtl/h0DHfRJl170U6OGpCkN34jX0a
GGGSHbFu2KxLUHsCIAFxXa6UsQOf93vT0FQldeBodbVCbNhM8/jtVqfZ/lhB
-----ENDCERTIFICATEREQUEST-----
&Notes=test
&<公共请求参数>输出示例
{
"Response": {
"CertDn": "C=CN,ST=ShenZhen,L=4ShenZhen,O=org1,OU=client,CN=kylouse@org1.bcdk3eis17qe@client",
"CertId": 172634,
"RequestId": "16824370-6058-4f38-a32d-c19b1eaefaee"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| AuthFailure.UnauthorizedOperation | 用户无权限访问。 |
| FailedOperation.CaCheckCsr | 检查CSR文件非法。 |
| FailedOperation.CaDbOption | 数据库操作错误。 |
| FailedOperation.CaExsit | 证书已经存在。 |
| FailedOperation.CaGenkey | 产生密钥对失败。 |
| FailedOperation.CaInit | 初始化CA失败。 |
| FailedOperation.CaInputParam | 输入参数非法。 |
| FailedOperation.CaNoExist | 证书不存在。 |
| FailedOperation.CaRevoke | 注销证书失败。 |
| FailedOperation.CaRootNonExist | 根证书不存在。 |
| FailedOperation.CaService | CA内部错误。 |
| FailedOperation.CaSignCert | 签发证书失败。 |
| FailedOperation.CaYunApiApplyCert | CFCA云API申请证书失败。 |
| FailedOperation.CaYunApiCommon | CFCA云API错误。 |
| FailedOperation.GroupIllegal | 用户非法操作。 |
| FailedOperation.UserAuthType | 获取用户认证类型出错。 |
| InternalError.FlaskException | Flask内部错误。 |
| InternalError.NoDefineError | 错误码未定义。 |
| InternalError.ServerException | 服务器异常。 |
| InvalidParameterValue.IllegalFormat | 参数格式不正确。 |
| InvalidParameterValue.IllegalValue | 请求参数错误。 |
| InvalidParameterValue.ParameterEmpty | 参数值为空。 |
