快速开始
集成 / SDK
用户验证
企业验证
交易监控
更新日志curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_company_registry" \
-F "vendor_data=user-1234" \
-F "company_registration_number=REG-123456"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_company_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_company_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 南非
南非公司登记查询 API
南非公司登记查询：通过 Didit 查询南非权威数据库。按次计费，起价 $0.75，无合同、无最低消费。
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_company_registry" \
-F "vendor_data=user-1234" \
-F "company_registration_number=REG-123456"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_company_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_company_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
根据注册号在 CIPC 商业注册簿中查询南非企业。Didit 通过
POST /v3/database-validation/ 提供此服务，便于您将提交的数据与权威数据源进行核验，并获取标准化的匹配结果。
覆盖范围
- 覆盖范围： —
- 国家： 南非
- 服务 ID：
zaf_company_registry - 数据领域： 政府
- 类别： CompanyRegister
输入
| 字段 | 必填 | 示例 |
|---|---|---|
company_registration_number | 是 | REG-123456 |
company_name | 否 | Sample Company LLC |
vendor_data | 否 | user-1234 |
- 必填输入：
company_registration_number - 可选输入：
company_name、vendor_data - 同意： 无需
- 工作流可用性： 可在工作流中使用，需进行字段映射
- 覆盖范围： —
- 价格： 每次成功查询 $0.75
company_registration_number，因此没有任何步骤能单独产生该值。请从问卷答案、Document AI 提取字段，或您在创建会话时发送的值中收集它，并将其映射到数据库核验步骤。在完成映射之前，工作流编辑器会将此服务显示为禁用状态，并指出缺少的输入；运行时若缺少输入，则会在任何查询之前跳过该检查，因此不会为无法查询的数据库计费。
请求体参数
string
默认值:"ZAF"
必填
此数据库服务的 ISO 3166-1 alpha-3 国家代码。示例：
ZAFstring
默认值:"zaf_company_registry"
必填
包含此服务 ID 的数组。固定该服务可将请求限定在这一特定数据库范围内。示例：
zaf_company_registrystring
默认值:"REG-123456"
必填
此数据库服务所需的
company_registration_number 值。示例：REG-123456string
此数据库服务所需的
company_name 值。示例：Sample Company LLCstring
默认值:"user-1234"
您为该用户设置的稳定用户标识，例如您内部的用户 ID。Didit 用它将独立检查关联到同一终端用户，并减少重复检测的干扰。示例：
user-1234输入规则与验证说明
- 请原样发送上述字段，与从用户或证件中采集到的内容保持一致。
- Didit 会在调用数据库之前校验必填字段。在到达数据源查询之前被拒绝的请求不收费。
调用方法
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_company_registry" \
-F "vendor_data=user-1234" \
-F "company_registration_number=REG-123456"
每次成功调用都会返回 HTTP 200。outcome_code 字段会告诉您实际发生了什么，例如区分真正的生物识别不匹配（BIOMETRIC_NO_MATCH）与无法读取的自拍照（BIOMETRIC_IMAGE_UNUSABLE）。显示的 status 是默认的功能状态；您配置的部分匹配 / 不匹配操作可以覆盖它。MATCH：公司登记簿已确认身份，且所有被核验的字段均匹配。{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_company_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH：注册局未返回与所提交数据匹配的结果。{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_company_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
返回数据
source_data 中实际返回的字段取决于注册局的返回内容。为 zaf_company_registry 生成的示例目前记录了以下标准化结构：
- 因注册局返回内容而异。
定价与 SLA
南非 - 公司登记查询仅在 Didit 从核验数据源获得确定结果时计费。- 单次调用价格： $0.75 USD。
- 计费方式： 按每次成功查询计费。若注册局无法访问、缺少必填字段，或请求在到达数据源之前即被拒绝，则不收费。
- 延迟： 典型 p95 低于 2 秒。
- 可用性： Didit 侧每季度 99.9%；下游数据源的可用性因国家和数据集而异。
继续阅读
最后修改于 2026年11月7日