Gegevensextractie
Een OCR-API voor het scannen van ID's die gestructureerde velden teruggeeft, geen tekstblok.
ShieldID zet een officieel foto-ID om in gestructureerde gegevens per veld: naam, geboortedatum, documentnummer, vervaldatum, adres en meer, elk met zijn bron en zijn eigen uitkomst. Een API voor documentgegevensextractie en een API voor documentverificatie in dezelfde sessie.
Wat u terugkrijgt
Gestructureerde velden, voor zover het document ze daadwerkelijk bevat.
Niet elk document bevat elk veld. ShieldID geeft terug wat het document bevat en markeert wat het niet bevat.
- Volledige naam
- Zoals afgedrukt en zoals gecodeerd in de barcode of de MRZ, voor zover het document daarover beschikt.
- Geboortedatum
- Uitgelezen van de afgedrukte voorzijde en gecontroleerd aan de hand van de barcode en de MRZ.
- Documentnummer
- Rijbewijsnummer of paspoortnummer, gecontroleerd op interne consistentie waar het formaat van de uitgever dat toelaat.
- Vervaldatum
- Uitgelezen van de afgedrukte voorzijde en de barcode of MRZ.
- Adres
- Uitgelezen van de afgedrukte voorzijde en, indien aanwezig, de barcode; vergelijkbaar met een apart geüpload adresdocument.
- Geslacht
- Uitgelezen waar het document het afdrukt of codeert.
- Uitgevende jurisdictie
- Geïdentificeerd aan de hand van de uitgevercode in de barcode wanneer het document een herkende code bevat, voor zover beschikbaar.
Drie bronnen, één vergelijking
Barcode, MRZ en de bedrukte voorzijde, bewust gelezen en niet per ongeluk vermengd.
Elk veld wordt toegeschreven aan de bron waaruit het afkomstig is. Wanneer twee bronnen niet overeenkomen, is dat een markering op het resultaat, geen gemiddelde van de twee waarden.
PDF417-barcode
De achterzijde van een Noord-Amerikaans rijbewijs of een Noord-Amerikaanse identiteitskaart wordt gedecodeerd naar gestructureerde AAMVA-velden. Wanneer een document een barcode bevat, hebben de velden daarvan voorrang op de bedrukte voorzijde.
Paspoort-MRZ
De machineleesbare zone wordt gelokaliseerd, gelezen en gevalideerd aan de hand van de ICAO-controlecijferformules die in de zone zijn ingebouwd. Een minimale geldigheidsscore, getoetst aan die score, bepaalt of een uit de MRZ gelezen veld überhaupt wordt vertrouwd. Een zone die haar eigen controlesom niet doorstaat, mag een schonere bron niet overrulen.
Gestructureerde OCR en OCR van de volledige pagina van de voorzijde
De bedrukte zijde wordt uitgelezen aan de hand van de eigen lay-out van het document, wanneer die wordt herkend, met OCR van de volledige pagina als terugvaloptie, zodat ook een onbekend document leesbare velden oplevert.
Conflicten worden gemarkeerd, niet gemiddeld
Een naam of geboortedatum die niet overeenkomt tussen de voorzijde, de barcode en de MRZ, wordt op het resultaat gemeld als afwijking. Nergens in de pipeline wordt stilzwijgend een winnaar gekozen en het verschil verborgen.
Validatie van de MRZ-controlesom
Een machineleesbare zone moet haar eigen berekening laten kloppen voordat wij haar vertrouwen.
De ICAO-machineleesbare zone op een paspoort bevat van nature controlecijfers. ShieldID valideert deze voordat een uit de MRZ gelezen veld als betrouwbaar wordt beschouwd.
Een speciale detector lokaliseert de MRZ, een lezer haalt de tekens eruit en het resultaat krijgt een geldigheidsscore op basis van de eigen controlesomformules van de zone. Alleen een veld dat de minimale geldigheidsscore haalt, wordt met volledige prioriteit vertrouwd. Een zone die slecht leesbaar is, wordt daarnaar behoren behandeld in plaats van doorgegeven alsof ze schoon is.
Barcode eerst
Wanneer bronnen overlappen, wint de meest betrouwbare.
Hetzelfde veld kan op de barcode, in de MRZ en op de bedrukte voorzijde voorkomen. ShieldID lost dat elke keer op met dezelfde vaste volgorde.
- PDF417-barcode
- Paspoort-MRZ, zodra de controlesom klopt
- Gestructureerde uitlezing van de bedrukte voorzijde
- OCR van de volledige pagina als terugvaloptie
Adresdocumenten
Upload een tweede document en ontvang een eenvoudige adresvergelijking.
Wanneer een verificatie een bewijs van adres vereist, uploadt de aanvrager een apart document en leest ShieldID dit op dezelfde manier als het identiteitsbewijs.
Het adresdocument wordt via OCR verwerkt en het adres wordt vergeleken met het adres dat van het identiteitsdocument is gelezen. Dit is een eenvoudige tekst- en tokenvergelijking, geen aparte documentclassificatie, en deze wordt alleen uitgevoerd wanneer de sessie erom vraagt en er daadwerkelijk een document is aangeleverd.
Redactie en omgang met PII
Geëxtraheerde gegevens worden op dezelfde manier beschermd als de beelden.
Gestructureerde velden vallen onder dezelfde privacymaatregelen als de foto's van het identiteitsbewijs zelf.
Geboortedatum versleuteld opgeslagen
De geboortedatum wordt versleuteld opgeslagen; de service draait niet zonder dat de versleutelingssleutel aanwezig is.
Beelden worden na een ingestelde termijn verwijderd
De vastgelegde beelden van het document en de selfie worden automatisch verwijderd na een korte termijn, standaard zeven dagen. Met een vast interval en kort na elke herstart wordt een opschoonronde uitgevoerd, zodat een beeld ook in een rustige periode nooit langer blijft staan dan de dag waarop het verwijderd moet zijn.
Scoreredactie op het apparaat
Waar een match- of betrouwbaarheidscijfer anders op de eigen telefoon van de aanvrager zou worden getoond, verwijdert ShieldID het onderliggende percentage uit dat bericht voordat het wordt weergegeven, zodat een ruwe score nooit buiten uw account zichtbaar wordt.
Het dossier overleeft de beelden
De beelden worden volgens een schema verwijderd. Het feit dat een verificatie heeft plaatsgevonden en wat daaruit is gebleken, blijft in uw account bewaard en, bij een Trust Ledger-integratie, als geverifieerd/mislukt-vermelding in het Activity Ledger (vermeldingen in het grootboek voor ShieldID API-accounts: binnenkort beschikbaar).
Voorbeeldresultaat
Verdicten per veld, in de vorm waarin de API ze teruggeeft.
Namen, nummers en adressen hieronder zijn verzonnen voor dit voorbeeld. De velden, de bronvermelding en de verdicten hebben de echte vorm van een resultaat.
| Veld | Waarde | Bron | Verdict |
|---|---|---|---|
| person.name | "Priya Chandrasekaran" | barcode | match |
| person.dob | "1991-07-22" | barcode | match |
| person.document_number | "C4839201" | mrz | match |
| person.document_country | "CA" | barcode issuer code | match |
| person.address | "18 Spruce Ave, Ottawa ON" | barcode | match |
| identity.name_match | PASS | front vs barcode vs requester | PASS |
| checks.document_tamper | "no_indication" | advisory model | advisory — not gating |
// Sample result. Names, numbers and addresses are fictional.
{
"session_id": "ses_9f2c...sample",
"status": "VERIFIED",
"environment": "sandbox",
"person": {
"name": "Priya Chandrasekaran",
"dob": "1991-07-22",
"document_type": "DRIVERS_LICENCE",
"document_country": "CA",
"document_jurisdiction": "ON",
"address": "18 Spruce Ave, Ottawa ON"
},
"identity": {
"checks": ["name_match"],
"warnings": [],
"sources": {
"name": "barcode",
"dob": "barcode",
"address": "barcode"
}
},
"checks": {
"document": "PASS",
"identity": "PASS",
"document_tamper": "no_indication"
},
"completed_at": "2026-09-17T14:02:11Z"
}Integratienotities
Dezelfde velden, waar u het resultaat ook uitleest.
Gestructureerde velden zijn geen apart product naast de verificatiesessie. Ze komen binnen als onderdeel van hetzelfde resultaat.
- Velden worden geleverd in het sessieresultaat dat u via de API ophaalt zodra een verificatie is voltooid.
- Hetzelfde resultaat wordt door een ondertekende webhook naar uw endpoint gestuurd zodra de verificatie is afgerond, zodat u niet hoeft te pollen.
- Elk veld is toegeschreven aan zijn bron en heeft een eigen uitkomst, zowel in het API-resultaat als in de webhook-payload.
- Sandbox-sessies geven dezelfde veldstructuur terug als productie, zodat u uw integratie kunt bouwen voordat er één echt document is gelezen.
Vragen
Duidelijke antwoorden over gegevensextractie.
Bekijk de velden zelf
Voer een sandbox-verificatie uit en lees het gestructureerde resultaat.
Maak een sandbox-sessie aan, scan een document met uw eigen telefoon en zie elk veld, de bron ervan en de uitkomst in de respons. Sandbox-sessies worden nooit gefactureerd.