Saltar al contingut principal
POST
Verifica la cèdula panamenya amb una coincidència facial biomètrica contra el servei biomètric SIB del Tribunal Electoral. Nivell estàndard. Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: —
  • País: Panamà
  • ID del servei: pan_cedula_sib
  • Àmbit de dades: Identitat
  • Categoria: NationalIDRegistry

Entrades

  • Entrades obligatòries: personal_number, selfie
  • Entrades opcionals: vendor_data
  • Consentiment: No cal
  • Disponibilitat al flux de treball: Disponible al flux de treball
  • Cobertura: —
  • Preu: $1.25 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"PAN"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de bases de dades.Exemple: PAN
string
predeterminat:"pan_cedula_sib"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: pan_cedula_sib
string
predeterminat:"8-123-456"
requerit
Número d’identitat personal específic del país.Exemple: 8-123-456
file
requerit
Fitxer d’imatge selfie a pujar per a la validació biomètrica en bases de dades. Formats acceptats: JPEG, PNG o WebP.Exemple: @./selfie.jpg
string
predeterminat:"user-1234"
La teva referència estable d’usuari 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ó

  • Cèdula panamenya (mínim 5 caràcters)
  • personal_number ha de tenir entre 5 i 20 caràcters.
  • personal_number ha d’utilitzar lletres majúscules.
  • personal_number ha de coincidir amb (?:\d{1,2}(?:-?(?:AV|PI))?|PE|E|N)[\d-]*.

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 pan_cedula_sib documenta actualment aquesta forma normalitzada:
  • identification_number

Preus i SLA

Panamà: les consultes de cèdula amb coincidència facial biomètrica (SIB) només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $1.25 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 la font dependent varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026