1. 接口描述
接口请求域名: ocr.tencentcloudapi.com 。
提供比对校验企业名称、统一社会信用代码、法人姓名、注册登记证件号码一致性的服务,助力快速核验企业资质。
注意:
存在个别特殊情况下核验结果不准确,请选用前知悉;
按周更新企业信息变更情况,如遇到未及时更新的情况,可联系在线客服转产品团队进行人工处理。
默认接口请求频率限制:20次/秒。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:VerifyBizLicenseEnterprise4。 |
| Version | 是 | String | 公共参数,本接口取值:2018-11-19。 |
| Region | 否 | String | 公共参数,此参数为可选参数。 |
| CreditCode | 是 | String | 统一社会信用代码 示例值:911101085636548888 |
| EntName | 是 | String | 企业名称 示例值:腾云计算机(北京)有限责任公司 |
| LrName | 是 | String | 法人代表 示例值:张三 |
| IdNum | 是 | String | 注册登记证件号码 示例值:440304198805190026 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| StatusCode | Integer | 请求状态 枚举值:
示例值:0 |
| VerifyResult | Integer | 验证结果 示例值:1 |
| IsCreditCodeConsistent | Boolean | 统一社会信用代码是否一致 示例值:true |
| IsEntNameConsistent | Boolean | 企业名称是否一致 示例值:true |
| IsLrNameConsistent | Boolean | 法人代表是否一致 示例值:true |
| IsIdNumConsistent | Boolean | 注册登记证件号码是否一致 示例值:true |
| OperatingStatus | String | 经营状态 枚举值:
示例值:1 |
| OperatingPeriod | String | 营业期限:一般包括营业开始时间和结束时间 参数格式:yyyy-MM-dd/yyyy-MM-dd 无固定期限的格式为:yyyy-MM-dd/ 示例值:2020-02-24/ |
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 企业四要素核验
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: VerifyBizLicenseEnterprise4
<公共请求参数>
{
"CreditCode": "92130aaaaaaaa1BXA",
"EntName": "隆aaaaaaaa商户)",
"LrName": "aba",
"IdNum": "13aaaaaaaa6"
}
输出示例
{
"Response": {
"IsCreditCodeConsistent": true,
"IsEntNameConsistent": true,
"IsIdNumConsistent": false,
"IsLrNameConsistent": true,
"OperatingPeriod": "/",
"OperatingStatus": "1",
"RequestId": "6e6ef488-b1cf-4722-8f36-ae9386c22cb2",
"StatusCode": 0,
"VerifyResult": 0
}
}
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: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.EngineRecognizeTimeout | 引擎识别超时。 |
| InternalError | 内部错误。 |
| InvalidParameterValue.InvalidParameterValueLimit | 参数值错误。 |