> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API верификации национального ID Китая: поиск личности

> Китайский национальный ID: проверка по официальной базе Китая через инфраструктуру Didit. Оплата за вызов от $0.50, без контрактов и минимальных объёмов.

Проверяет введённые данные по официальному сервису данных в Китае. Didit предоставляет этот сервис через `POST /v3/database-validation/`, чтобы вы могли сверить отправленные данные с первоисточником и получить нормализованные результаты сопоставления. Формат ввода: `date_of_birth` принимает дату рождения, которая должна совпадать с датой, закодированной в китайском национальном идентификационном номере (цифры 7–14 из 18-значного номера или цифры 7–12 из устаревшего 15-значного).

## Покрытие

* **Покрытие:** \~ 100%
* **Страна:** Китай
* **Service ID:** `chn_national_id`
* **Домен данных:** Identity
* **Категория:** NationalIDRegistry

## Входные данные

| Поле | Обязательно | Пример |
| - | -: | - |
| `full_name` | Да | `王新伟` |
| `date_of_birth` | Да | `1990-01-01` |
| `national_id` | Да | `11010519900101003X` |
| `vendor_data` | Нет | `user-1234` |

* **Обязательные входные данные:** `full_name`, `date_of_birth`, `national_id`
* **Необязательные входные данные:** `vendor_data`
* **Согласие:** обязательно
* **Доступность в сценарии:** доступно в сценарии
* **Покрытие:** \~ 100%
* **Цена:** \$0.50 за успешный запрос

Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется как **неприменимо**: база данных не запрашивается, и с вас не взимается плата. В некоторых странах такие пользователи составляют значительную долю реальных пользователей. Чтобы охватить их, также собирайте идентификатор из ответа на анкету, поля извлечения Document AI или значения, которое вы передаёте при создании сессии, и сопоставьте его с шагом «Проверка по базам данных».

## Параметры тела запроса

**issuing\_state** `string` *required* (default: CHN)

Код страны по ISO 3166-1 alpha-3 для этого сервиса баз данных.

Пример: `CHN`

**services** `string` *required* (default: chn\_national\_id)

Массив, содержащий ID этого сервиса. Закрепление сервиса ограничивает запрос именно этой базой данных.

Пример: `chn_national_id`

**consent** `boolean` *required* (default: true)

Явное согласие конечного пользователя на этот сервис.

Пример: `true`

**full\_name** `string` *required* (default: 王新伟)

Полное официальное имя для проверки.

Пример: `王新伟`

**date\_of\_birth** `string` *required* (default: 1990-01-01)

Дата рождения в формате `YYYY-MM-DD`.

Пример: `1990-01-01`

**national\_id** `string` *required* (default: 11010519900101003X)

Национальный идентификационный номер для этого сервиса.

Пример: `11010519900101003X`

**vendor\_data** `string` (default: user-1234)

Ваш постоянный идентификатор пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при поиске дубликатов.

Пример: `user-1234`

## Правила ввода и примечания по валидации

* Дата рождения должна совпадать с датой, закодированной в китайском национальном идентификационном номере (цифры 7–14 из 18-значного номера или цифры 7–12 из устаревшего 15-значного)
* `date_of_birth` должна совпадать с датой рождения, закодированной в `national_id`; источник сразу отклоняет запрос, если две даты не совпадают, поэтому запрос с несовпадением отклоняется до поиска и плата не взимается.
* `national_id` должен соответствовать шаблону `(\d{15}|\d{17}[\dXx])`.
* Проверяется последний контрольный символ китайского удостоверения личности гражданина.
* `full_name` должно быть оригинальным написанием имени на китайском языке, как в реестре или в документе. Для проверок по базам данных Китая не отправляйте латинскую транслитерацию.

## Как вызвать

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=CHN" \
  -F "services=chn_national_id" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "full_name=王新伟" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=11010519900101003X"
```

```python Python theme={null}
from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="CHN",
    services=["chn_national_id"],
    consent=True,
    full_name="王新伟",
    date_of_birth="1990-01-01",
    national_id="11010519900101003X",
    vendor_data="user-1234",
)
print(result)
```

```javascript Node.js theme={null}
import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.databaseValidation.validate({
  issuing_state: "CHN",
  services: ["chn_national_id"],
  consent: true,
  full_name: "王新伟",
  date_of_birth: "1990-01-01",
  national_id: "11010519900101003X",
  vendor_data: "user-1234",
});
console.log(result);
```

```go Go theme={null}
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
	IssuingState: "CHN",
	Services:     didit.Some([]string{"chn_national_id"}),
	Consent:      didit.Bool(true),
	FullName:     didit.String("王新伟"),
	DateOfBirth:  didit.String("1990-01-01"),
	NationalID:   didit.String("11010519900101003X"),
	VendorData:   didit.String("user-1234"),
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)
```

```java Java theme={null}
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
        .issuingState("CHN")
        .services(List.of("chn_national_id"))
        .consent(true)
        .fullName("王新伟")
        .dateOfBirth(LocalDate.parse("1990-01-01"))
        .nationalId("11010519900101003X")
        .vendorData("user-1234")
        .build());
System.out.println(result);
```

```php PHP theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->databaseValidation->validate([
    'issuing_state' => 'CHN',
    'services' => ['chn_national_id'],
    'consent' => true,
    'full_name' => '王新伟',
    'date_of_birth' => '1990-01-01',
    'national_id' => '11010519900101003X',
    'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
```

```ruby Ruby theme={null}
require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.database_validation.validate(
  issuing_state: "CHN",
  services: ["chn_national_id"],
  consent: true,
  full_name: "王新伟",
  date_of_birth: "1990-01-01",
  national_id: "11010519900101003X",
  vendor_data: "user-1234"
)
puts result.to_h
```

```csharp .NET theme={null}
using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
    IssuingState = "CHN",
    Services = new string[] { "chn_national_id" },
    Consent = true,
    FullName = "王新伟",
    DateOfBirth = "1990-01-01",
    NationalId = "11010519900101003X",
    VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
```

Каждый успешный вызов возвращает HTTP `200`. Поле **`outcome_code`** показывает, что произошло на самом деле, например отличает реальное биометрическое несовпадение (`BIOMETRIC_NO_MATCH`) от селфи, которое не удалось прочитать (`BIOMETRIC_IMAGE_UNUSABLE`). Показанный `status` соответствует статусу функции по умолчанию; ваши настроенные [действия при частичном совпадении и отсутствии совпадения](https://docs.didit.me/ru/core-technology/database-validation/database-validation-warnings.md) могут его переопределить.

**`MATCH`**: реестр подтвердил личность, и все проверенные поля совпали.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "CHN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "chn_national_id",
      "service_name": "China National ID",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "identification_number": "11010519900101003X",
        "verifications": {
          "date_of_birth": true,
          "full_name": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`PARTIAL_MATCH`**: идентификационный номер найден, но одно или несколько персональных полей (обычно имя или дата рождения) не полностью совпали.

```json 200 OK — PARTIAL_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "CHN",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "chn_national_id",
      "service_name": "China National ID",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "identification_number": "11010519900101003X",
        "verifications": {
          "date_of_birth": true,
          "full_name": false,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "no_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: реестр не вернул совпадений для отправленных данных.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "CHN",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "chn_national_id",
      "service_name": "China National ID",
      "source_data": {
        "date_of_birth": "NO_MATCH",
        "full_name": "NO_MATCH",
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "date_of_birth": "no_match",
        "full_name": "no_match",
        "identification_number": "no_match"
      }
    }
  ]
}
```

## Возвращаемые данные

Точный набор полей в `source_data` зависит от того, что возвращает реестр. Сгенерированный пример для `chn_national_id` на данный момент описывает следующую нормализованную структуру:

* `date_of_birth`
* `identification_number`

## Цены и SLA

Запросы China National ID тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.

* **Цена за вызов:** \$0.50 USD.
* **Тарификация:** за успешный запрос. Плата не взимается, если реестр недоступен, если не заполнены обязательные поля или если запрос отклонён до передачи источнику.
* **Задержка:** типичное значение p95 менее 2 с.
* **Доступность:** 99.9% в квартал со стороны Didit; доступность источников данных зависит от страны и набора данных.

## Продолжите чтение

* [Обзор проверки по базам данных для Китая](https://docs.didit.me/api-reference/database-validation/china.md)
* [Обзор проверки по базам данных](https://docs.didit.me/ru/core-technology/database-validation/overview.md)
* [Коды результатов](https://docs.didit.me/ru/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.