> ## 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 telefonica Francia: API ricerca in tempo reale > Verifica telefonica in Francia tramite la validazione su database di Didit. Da $1.12 a chiamata, senza contratti né minimi. Verifica i dati di input rispetto ai dati telefonici degli operatori di rete mobile. Didit espone questo servizio tramite `POST /v3/database-validation/` per verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. ## Copertura * **Copertura:** \~ 90% * **Paese:** Francia * **ID servizio:** `fra_phone` * **Dominio dati:** Telecomunicazioni * **Categoria:** Telecomunicazioni ## Input | Campo | Obbligatorio | Esempio | | - | -: | - | | `first_name` | Sì | `John` | | `last_name` | Sì | `Doe` | | `phone` | Sì | `+15550101000` | | `date_of_birth` | No | `1990-01-01` | | `address.street_1` | No | `123 Sample Street` | | `address.street_2` | No | `Unit 4` | | `address.city` | No | `Sample City` | | `address.region` | No | `Sample State` | | `address.postal_code` | No | `10001` | | `vendor_data` | No | `user-1234` | * **Campi obbligatori:** `first_name`, `last_name`, `phone` * **Campi facoltativi:** `date_of_birth`, `address.street_1`, `address.street_2`, `address.city`, `address.region`, `address.postal_code`, `vendor_data` * **Consenso:** Non richiesto * **Disponibilità nel workflow:** Disponibile nel workflow * **Copertura:** \~ 90% * **Prezzo:** \$1.12 per query riuscita ## Parametri del corpo **issuing\_state** `string` *required* (default: FRA) Codice paese ISO 3166-1 alpha-3 per questo servizio di database. Esempio: `FRA` **services** `string` *required* (default: fra\_phone) Array contenente questo ID servizio. Specificare il servizio mantiene la richiesta limitata a questo database specifico. Esempio: `fra_phone` **first\_name** `string` *required* (default: John) Nome di battesimo da verificare. Esempio: `John` **last\_name** `string` *required* (default: Doe) Cognome da verificare. Esempio: `Doe` **phone** `string` *required* (default: +15550101000) Numero di telefono in formato internazionale. Esempio: `+15550101000` **date\_of\_birth** `string` Data di nascita nel formato `YYYY-MM-DD`. Esempio: `1990-01-01` **address** `object` Oggetto di indirizzo residenziale strutturato. Usa `street_1`, `street_2`, `city`, `region`, `postal_code` e `country`. Una stringa di indirizzo precedente completa è ancora accettata ma non consigliata. Esempio: `{"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}` **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 i controlli autonomi allo stesso utente finale e ridurre il rumore dovuto ai rilevamenti di duplicati. Esempio: `user-1234` ## Regole di input e note di validazione * `address` è facoltativo per questo servizio. Puoi inviare una stringa `address` completa e Didit la suddividerà in elementi di indirizzo strutturati quando possibile, oppure puoi inviare esplicitamente i campi strutturati. * Per i servizi basati sull'indirizzo, invia i campi di indirizzo strutturati invece di una singola stringa `address`, quando possibile. * `address.street_1` è l'indirizzo stradale, incluso il numero civico e il tipo di via. * `address.street_2` è l'appartamento, l'interno, l'edificio, il piano o una riga aggiuntiva dell'indirizzo. Invialo solo se lo hai. * `address.city` è la città, il sobborgo, il distretto, la località o il quartiere. * `address.region` è lo stato, la provincia, la regione o il comune. * `address.postal_code` è il codice postale. * I servizi di database basati sull'indirizzo richiedono almeno l'indirizzo stradale e il codice postale; le richieste rifiutate prima della ricerca nella fonte non vengono addebitate. ## 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=FRA" \ -F "services=fra_phone" \ -F "vendor_data=user-1234" \ -F "first_name=John" \ -F "last_name=Doe" \ -F "phone=+15550101000" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="FRA", services=["fra_phone"], first_name="John", last_name="Doe", phone="+15550101000", 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: "FRA", services: ["fra_phone"], first_name: "John", last_name: "Doe", phone: "+15550101000", 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: "FRA", Services: didit.Some([]string{"fra_phone"}), FirstName: didit.String("John"), LastName: didit.String("Doe"), Phone: didit.String("+15550101000"), 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("FRA") .services(List.of("fra_phone")) .firstName("John") .lastName("Doe") .phone("+15550101000") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'FRA', 'services' => ['fra_phone'], 'first_name' => 'John', 'last_name' => 'Doe', 'phone' => '+15550101000', '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: "FRA", services: ["fra_phone"], first_name: "John", last_name: "Doe", phone: "+15550101000", 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 = "FRA", Services = new string[] { "fra_phone" }, FirstName = "John", LastName = "Doe", Phone = "+15550101000", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` Ogni chiamata riuscita restituisce HTTP `200`. Il campo **`outcome_code`** indica cosa è successo effettivamente, distinguendo ad esempio una vera 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 tue [azioni configurate per corrispondenza parziale / nessuna corrispondenza](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) possono sovrascriverlo. **`MATCH`**: il registro ha confermato l'identità e ogni campo verificato corrispondeva. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "FRA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "fra_phone", "service_name": "France Phone", "source_data": { "address": "123 Sample Street", "date_of_birth": "1990-01-01", "first_name": "John", "last_name": "Doe" }, "validation": { "full_name": "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": "FRA", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "fra_phone", "service_name": "France Phone", "source_data": { "full_name": "NO_MATCH" }, "validation": { "full_name": "no_match" } } ] } ``` ## Dati restituiti I campi esatti esposti in `source_data` dipendono da ciò che il registro restituisce. L'esempio generato per `fra_phone` documenta attualmente questa struttura normalizzata: * `address` * `date_of_birth` * `first_name` * `last_name` ## Prezzi e SLA Le query France Phone vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione. * **Prezzo per chiamata:** \$1.12 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 inferiore a 2 s. * **Disponibilità:** 99.9% per trimestre lato Didit; la disponibilità delle fonti a valle varia in base al paese e all'insieme di dati. ## Continua la lettura * [Panoramica della Validazione su database per la Francia](https://docs.didit.me/api-reference/database-validation/france.md) * [Panoramica della 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.