> ## 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.

# Verificació de llicència de conducció de Nigèria (FRSC)

> Consulta de llicències de conducció de Nigèria (FRSC) a la base de dades oficial, amb Didit. Des de $0.20 per crida, sense contractes ni mínims.

Verifica una llicència de conducció nigeriana contra el registre de llicències de la Federal Road Safety Corps. El registre només respon quan el número de llicència, els noms i la data de naixement corresponen a la mateixa persona. Didit ofereix aquest servei a través de `POST /v3/database-validation/` perquè puguis verificar les dades enviades contra la font autoritzada i rebre resultats de coincidència normalitzats.

## Cobertura

* **Cobertura:** \~ 100%
* **País:** Nigèria
* **ID del servei:** `nga_drivers_license`
* **Àmbit de dades:** Identitat
* **Categoria:** DriverLicence

## Entrades

| Camp | Obligatori | Exemple |
| - | -: | - |
| `driver_license_number` | Sí | `ABC12345AA12` |
| `first_name` | Sí | `John` |
| `last_name` | Sí | `Doe` |
| `date_of_birth` | Sí | `1990-01-01` |
| `vendor_data` | No | `user-1234` |

* **Entrades obligatòries:** `driver_license_number`, `first_name`, `last_name`, `date_of_birth`
* **Entrades opcionals:** `vendor_data`
* **Consentiment:** No cal
* **Disponibilitat:** Disponible al flux de treball
* **Cobertura:** \~ 100%
* **Preu:** \$0.20 per consulta satisfactòria

## Paràmetres del cos

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

Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.

Exemple: `NGA`

**services** `string` *required* (default: nga\_drivers\_license)

Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.

Exemple: `nga_drivers_license`

**driver\_license\_number** `string` *required* (default: ABC12345AA12)

Número de llicència de conducció.

Exemple: `ABC12345AA12`

**first\_name** `string` *required* (default: John)

Nom de pila a validar.

Exemple: `John`

**last\_name** `string` *required* (default: Doe)

Cognom a validar.

Exemple: `Doe`

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

Data de naixement en format `YYYY-MM-DD`.

Exemple: `1990-01-01`

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

La teva referència d'usuari estable per a aquesta persona, com ara el teu ID intern d'usuari. Didit l'utilitza per vincular les comprovacions independents al mateix usuari final i reduir el soroll de la detecció de duplicats.

Exemple: `user-1234`

## Regles d'entrada i notes de validació

* `driver_license_number` ha d'utilitzar lletres majúscules.
* `driver_license_number` ha de coincidir amb `[A-Z0-9]{8,20}`.

## Com fer la crida

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NGA" \
  -F "services=nga_drivers_license" \
  -F "vendor_data=user-1234" \
  -F "driver_license_number=ABC12345AA12" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01"
```

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

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="NGA",
    services=["nga_drivers_license"],
    first_name="John",
    last_name="Doe",
    date_of_birth="1990-01-01",
    driver_license_number="ABC12345AA12",
    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: "NGA",
  services: ["nga_drivers_license"],
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  driver_license_number: "ABC12345AA12",
  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:        "NGA",
	Services:            didit.Some([]string{"nga_drivers_license"}),
	FirstName:           didit.String("John"),
	LastName:            didit.String("Doe"),
	DateOfBirth:         didit.String("1990-01-01"),
	DriverLicenseNumber: didit.String("ABC12345AA12"),
	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("NGA")
        .services(List.of("nga_drivers_license"))
        .firstName("John")
        .lastName("Doe")
        .dateOfBirth(LocalDate.parse("1990-01-01"))
        .driverLicenseNumber("ABC12345AA12")
        .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' => 'NGA',
    'services' => ['nga_drivers_license'],
    'first_name' => 'John',
    'last_name' => 'Doe',
    'date_of_birth' => '1990-01-01',
    'driver_license_number' => 'ABC12345AA12',
    '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: "NGA",
  services: ["nga_drivers_license"],
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  driver_license_number: "ABC12345AA12",
  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 = "NGA",
    Services = new string[] { "nga_drivers_license" },
    FirstName = "John",
    LastName = "Doe",
    DateOfBirth = "1990-01-01",
    DriverLicenseNumber = "ABC12345AA12",
    VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
```

Cada crida satisfactòria retorna HTTP `200`. El camp **`outcome_code`** indica què ha passat realment, distingint, per exemple, una discrepància biomètrica real (`BIOMETRIC_NO_MATCH`) d'un selfie que no s'ha pogut llegir (`BIOMETRIC_IMAGE_UNUSABLE`). L'`status` mostrat és l'estat per defecte de la funcionalitat; les teves accions configurades per a [Coincidència parcial / Cap coincidència](https://docs.didit.me/ca/core-technology/database-validation/database-validation-warnings.md) el poden substituir.

**`MATCH`**: El registre ha confirmat la identitat i tots els camps comprovats coincideixen.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "NGA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nga_drivers_license",
      "service_name": "Nigeria Driver's Licence (FRSC)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`PARTIAL_MATCH`**: S'ha trobat el número d'identificació, però un o més camps personals (normalment el nom o la data de naixement) no coincideixen completament.

```json 200 OK — PARTIAL_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "NGA",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "nga_drivers_license",
      "service_name": "Nigeria Driver's Licence (FRSC)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "no_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: El registre no ha retornat cap coincidència per a les dades enviades.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "NGA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "nga_drivers_license",
      "service_name": "Nigeria Driver's Licence (FRSC)",
      "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"
      }
    }
  ]
}
```

**`DOCUMENT_NOT_FOUND`**: El número de document enviat no correspon a cap registre en el registre.

```json 200 OK — DOCUMENT_NOT_FOUND theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "NGA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "nga_drivers_license",
      "service_name": "Nigeria Driver's Licence (FRSC)",
      "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"
      }
    }
  ]
}
```

## Dades retornades

Els camps exactes que apareixen a `source_data` depenen del que retorni el registre. L'exemple generat per a `nga_drivers_license` documenta actualment aquesta estructura normalitzada:

* `date_of_birth`
* `first_name`
* `identification_number`
* `last_name`

## Preus i SLA

Les consultes de llicències de conducció de Nigèria (FRSC) només es facturen quan Didit rep un resultat concloent de la font de validació.

* **Preu per crida:** \$0.20 USD.
* **Facturació:** per consulta satisfactòria. No es cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d'arribar a la font.
* **Latència:** p95 típica \< 2 s.
* **Disponibilitat:** 99.9% per trimestre per part de Didit; la disponibilitat de la font posterior varia segons el país i el conjunt de dades.

## Continuar llegint

* [Visió general de la validació en bases de dades de Nigèria](https://docs.didit.me/api-reference/database-validation/nigeria.md)
* [Visió general de la validació en bases de dades](https://docs.didit.me/ca/core-technology/database-validation/overview.md)
* [Codis de resultat](https://docs.didit.me/ca/core-technology/database-validation/database-validation-outcome-codes.md)


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