快速开始
集成 / 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_directors" \
-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_directors",
"service_name": "South Africa - Company Directors 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_directors",
"service_name": "South Africa - Company Directors 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_directors" \
-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_directors",
"service_name": "South Africa - Company Directors 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_directors",
"service_name": "South Africa - Company Directors Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
从南非 CIPC 商业登记处返回南非公司的现任董事信息。Didit 通过
POST /v3/database-validation/ 提供此服务，便于您将提交的数据与权威数据源比对，并获得标准化的匹配结果。
覆盖范围
- 覆盖范围： —
- 国家/地区： 南非
- 服务 ID：
zaf_company_directors - 数据领域： 政府
- 类别： CompanyRegister
输入
| 字段 | 必填 | 示例 |
|---|---|---|
company_registration_number | 是 | REG-123456 |
vendor_data | 否 | user-1234 |
- 必填输入：
company_registration_number - 可选输入：
vendor_data - 同意： 无需同意
- 工作流可用性： 可在工作流中使用，需进行字段映射
- 覆盖范围： —
- 价格： 每次成功查询 $0.75
company_registration_number 不会印在任何身份证件上，因此没有任何步骤能单独产生该值。请从问卷答案、Document AI 提取字段，或您在创建会话时发送的值中收集它，并在数据库核验步骤中进行映射。在映射完成之前，工作流编辑器会将此服务显示为禁用状态，并指出缺失的输入。运行时若缺少输入，该检查会在任何查询之前被跳过，因此您不会为无法查询的数据库付费。
请求体参数
string
默认值:"ZAF"
必填
此数据库服务使用的 ISO 3166-1 alpha-3 国家/地区代码。示例：
ZAFstring
默认值:"zaf_company_directors"
必填
包含此服务 ID 的数组。固定该服务可将请求限定为仅查询此特定数据库。示例：
zaf_company_directorsstring
默认值:"REG-123456"
必填
此数据库服务所需的
company_registration_number 值。示例：REG-123456string
默认值:"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_directors" \
-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_directors",
"service_name": "South Africa - Company Directors 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_directors",
"service_name": "South Africa - Company Directors Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
返回数据
source_data 中实际返回的字段取决于登记处的返回内容。zaf_company_directors 的自动生成示例目前记录了以下标准化结构：
- 因登记处的返回内容而异。
定价与 SLA
南非 - 公司董事查询仅在 Didit 从验证源获得确定结果时计费。- 单次调用价格： $0.75 USD。
- 计费方式： 按每次成功查询计费。登记处无法访问、缺少必填字段，或请求在到达数据源之前被拒绝时，不收费。
- 延迟： 典型 p95 < 2 s。
- 可用性： Didit 侧每季度 99.9%；下游数据源的可用性因国家/地区和数据集而异。
延伸阅读
最后修改于 2026年11月7日