Saltar al contingut principal
POST
Servei agregat de registres governamentals i públics, registres d’antecedents i altres serveis. Didit exposa aquest servei mitjançant POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritzada i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: ~ 85%
  • País: Estats Units
  • ID del servei: usa_states_financial_services
  • Domini de dades: Financer
  • Categoria: FinancialServices

Entrades

  • Camps obligatoris: first_name, last_name, date_of_birth
  • Camps opcionals: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, ssn, email, vendor_data
  • Consentiment: No cal
  • Disponibilitat: Disponible en el flux de treball
  • Cobertura: ~ 85%
  • Preu: $0.20 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"USA"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de base de dades.Exemple: USA
string
predeterminat:"usa_states_financial_services"
requerit
Matriu que conté l’identificador d’aquest servei. Fixar el servei limita la sol·licitud a aquesta base de dades exacta.Exemple: usa_states_financial_services
string
predeterminat:"John"
requerit
Nom de pila a validar.Exemple: John
string
predeterminat:"Doe"
requerit
Cognoms a validar.Exemple: Doe
string
predeterminat:"1990-01-01"
requerit
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
object
Objecte d’adreça residencial estructurat. Utilitza street_1, street_2, city, region, postal_code i country. Encara s’accepta una cadena d’adreça completa en format antic, però no es recomana.Exemple: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Número de telèfon en format internacional.Exemple: +15550101000
string
Valor de ssn requerit per aquest servei de base de dades.Exemple: 123456789
string
Adreça de correu electrònic.Exemple: john.doe@example.com
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID intern d’usuari. Didit la fa servir per vincular les verificacions independents al mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • address és opcional per a aquest servei. Pots enviar una cadena address completa i Didit la dividirà en elements d’adreça estructurats quan sigui possible, o pots enviar els camps estructurats explícitament.
  • Número de la Seguretat Social dels EUA o ITIN: els 9 dígits complets (els guions són opcionals) o només els 4 últims dígits
  • ssn ha de coincidir amb (?:\d{9}|\d{3}-\d{2}-\d{4}|\d{4}).
  • Per a ssn, envia el SSN/ITIN complet de 9 dígits (els guions són opcionals) o només els seus 4 últims dígits.
  • Aquest servei requereix first_name, last_name i date_of_birth, cosa que ja compleix el mínim de la font: un nom més un altre camp d’identitat. Els camps opcionals (ssn, address, phone, email) reforcen encara més la coincidència.
  • Per als serveis d’adreça, envia els camps d’adreça estructurats en lloc d’una única cadena address quan sigui possible.
  • address.street_1 és l’adreça del carrer, inclosos el número i el tipus de via.
  • address.street_2 és el pis, la porta, l’edifici, la planta o una línia addicional d’adreça. Envia’l només quan en disposis.
  • address.city és la ciutat, el barri perifèric, el districte, la localitat o el barri.
  • address.region és l’estat, la província, la regió o el municipi.
  • address.postal_code és el codi postal.
  • Els serveis de base de dades basats en adreça requereixen com a mínim l’adreça del carrer i el codi postal; les sol·licituds rebutjades abans de la consulta a la font no es cobren.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a usa_states_financial_services documenta actualment aquesta estructura normalitzada:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • state
  • street

Preus i SLAs

Les consultes dels Estats Units d’Amèrica - Serveis financers dels Estats Units 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 se’t 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ípic < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de les fonts aigües avall varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026