> ## 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. # Verifica cédula Ecuador - API di ricerca in tempo reale > Verifica cédula in Ecuador: ricerca ufficiale nel database tramite l'infrastruttura di identità di Didit. Da $0.20 a chiamata, senza contratti né minimi. Verifica la Cédula ecuadoriana rispetto ai registri del Registro Civil. Didit espone questo servizio tramite `POST /v3/database-validation/` per confrontare i dati inviati con la fonte autorevole e ricevere risultati di corrispondenza normalizzati. Formato di input: `personal_number` accetta la Cédula ecuadoriana (esattamente 10 cifre). ## Copertura * **Copertura:** — * **Paese:** Ecuador * **ID servizio:** `ecu_cedula` * **Dominio dei dati:** Identità * **Categoria:** NationalIDRegistry ## Input | Campo | Obbligatorio | Esempio | | - | -: | - | | `personal_number` | Sì | `1111111111` | | `first_name` | No | `John` | | `last_name` | No | `Doe` | | `vendor_data` | No | `user-1234` | * **Input obbligatori:** `personal_number` * **Input facoltativi:** `first_name`, `last_name`, `vendor_data` * **Consenso:** non richiesto * **Disponibilità nel workflow:** disponibile nel workflow * **Copertura:** — * **Prezzo:** \$0.20 per query riuscita ## Parametri del body **issuing\_state** `string` *required* (default: ECU) Codice paese ISO 3166-1 alpha-3 per questo servizio di database. Esempio: `ECU` **services** `string` *required* (default: ecu\_cedula) Array che contiene questo ID servizio. Vincolare il servizio limita la richiesta a questo database specifico. Esempio: `ecu_cedula` **personal\_number** `string` *required* (default: 1111111111) Numero di identificazione personale specifico del paese. Esempio: `1111111111` **first\_name** `string` Nome da validare. Esempio: `John` **last\_name** `string` Cognome da validare. Esempio: `Doe` **vendor\_data** `string` (default: user-1234) Il tuo riferimento utente stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare le verifiche indipendenti allo stesso utente finale e ridurre il rumore nel rilevamento dei duplicati. Esempio: `user-1234` ## Regole sugli input e note di validazione * Cédula ecuadoriana (esattamente 10 cifre) * `personal_number` deve contenere solo cifre; rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta. * `personal_number` deve essere lungo esattamente 10 caratteri. ## Come effettuare la chiamata ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=ECU" \ -F "services=ecu_cedula" \ -F "vendor_data=user-1234" \ -F "personal_number=1111111111" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="ECU", services=["ecu_cedula"], personal_number="1111111111", 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: "ECU", services: ["ecu_cedula"], personal_number: "1111111111", 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: "ECU", Services: didit.Some([]string{"ecu_cedula"}), PersonalNumber: didit.String("1111111111"), VendorData: didit.String("user-1234"), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} 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("ECU") .services(List.of("ecu_cedula")) .personalNumber("1111111111") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'ECU', 'services' => ['ecu_cedula'], 'personal_number' => '1111111111', '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: "ECU", services: ["ecu_cedula"], personal_number: "1111111111", 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 = "ECU", Services = new string[] { "ecu_cedula" }, PersonalNumber = "1111111111", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` Ogni chiamata riuscita restituisce HTTP `200`. Il campo **`outcome_code`** indica cosa è effettivamente accaduto, distinguendo, ad esempio, una reale mancata corrispondenza biometrica (`BIOMETRIC_NO_MATCH`) da un selfie che non è stato possibile leggere (`BIOMETRIC_IMAGE_UNUSABLE`). Lo `status` mostrato è lo stato predefinito della funzionalità; le azioni configurate per [Partial Match / No Match](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) possono sovrascriverlo. **`MATCH`**: il registro ha confermato l'identità e tutti i campi controllati corrispondono. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "ECU", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "ecu_cedula", "service_name": "Ecuador - Cédula verification", "source_data": { "first_name": "John", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe" }, "validation": { "identification_number": "full_match" } } ] } ``` **`NO_MATCH`**: il registro non ha restituito alcuna corrispondenza per i dati inviati. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "ECU", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "ecu_cedula", "service_name": "Ecuador - Cédula verification", "source_data": { "identification_number": "NO_MATCH" }, "validation": { "identification_number": "no_match" } } ] } ``` ## Dati restituiti I campi esatti esposti in `source_data` dipendono da ciò che restituisce il registro. L'esempio generato per `ecu_cedula` documenta attualmente questa struttura normalizzata: * `first_name` * `identification_number` * `last_name` ## Prezzi e SLA Le query di verifica della Cédula in Ecuador vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione. * **Prezzo per chiamata:** \$0.20 USD. * **Fatturazione:** per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte. * **Latenza:** p95 tipico \< 2 s. * **Disponibilità:** 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset. ## Continua la lettura * [Panoramica di Validazione su database per l'Ecuador](https://docs.didit.me/api-reference/database-validation/ecuador.md) * [Panoramica di Validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md) * [Codici di esito](https://docs.didit.me/it/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.