Data extraction
Isang OCR ID scanning API na nagbabalik ng mga structured field, hindi isang bloke ng teksto.
Ginagawa ng ShieldID na structured at per-field na data ang government photo ID: pangalan, petsa ng kapanganakan, numero ng dokumento, expiry, address at iba pa, na bawat isa ay may kasamang source at sarili nitong verdict. Isang document data extraction API at document verification API sa iisang session.
Ano ang ibinabalik
Mga structured field, kung saan talagang taglay ng dokumento ang mga ito.
Hindi lahat ng dokumento ay may bawat field. Ibinabalik ng ShieldID ang mayroon sa dokumento, at minamarkahan ang wala.
- Buong pangalan
- Gaya ng nakaimprenta, at gaya ng naka-encode sa barcode o sa MRZ kung mayroon ang dokumento.
- Petsa ng kapanganakan
- Binabasa mula sa nakaimprentang mukha at kinukumpara sa barcode at sa MRZ.
- Numero ng dokumento
- Numero ng licence o numero ng pasaporte, sinusuri para sa internal na consistency kung pinapayagan ito ng format ng issuer.
- Petsa ng expiry
- Binabasa mula sa nakaimprentang mukha at sa barcode o MRZ.
- Address
- Binabasa mula sa nakaimprentang mukha at sa barcode kung mayroon; maaaring ikumpara sa hiwalay na na-upload na address document.
- Kasarian
- Binabasa kung saan ito inilalagay o ine-encode ng dokumento.
- Nag-isyu na hurisdiksyon
- Natutukoy mula sa barcode issuer code kung ang dokumento ay may kinikilalang code, ayon sa availability.
Tatlong source, isang paghahambing
Barcode, MRZ at ang nakaimprentang harap, binabasa nang sinadya, hindi hinahalo nang hindi sinasadya.
Bawat field ay may nakatalang source kung saan ito nanggaling. Kapag hindi nagkakasundo ang dalawang source, flag iyon sa resulta, hindi average ng dalawang numero.
PDF417 barcode
Ang likod ng driver's licence o ID card sa North America ay dine-decode sa structured na mga field ng AAMVA. Kapag may barcode ang dokumento, mas inuuna ang mga field nito kaysa sa nakalimbag na harap.
Passport MRZ
Hinahanap, binabasa, at vine-validate ang machine-readable zone laban sa mga ICAO check-digit formula na nakapaloob sa zone. Ang minimum na validity score, na sinusuri laban sa score na iyon, ang nagpapasya kung mapagkakatiwalaan ang isang field na nabasa mula sa MRZ — ang zone na pumapalya sa sarili nitong checksum ay hindi maaaring mag-override sa mas malinis na source.
Structured at full-page OCR ng harap
Binabasa ang nakalimbag na mukha ng dokumento gamit ang sariling layout ng dokumento kung may kinikilala, at gumagamit ng full-page OCR bilang panananggalang upang makakuha pa rin ng nababasang mga field mula sa hindi pamilyar na dokumento.
Ang mga conflict ay ina-flag, hindi ina-average
Ang pangalan o petsa ng kapanganakan na hindi magkatugma sa pagitan ng harap, ng barcode at ng MRZ ay iniuulat bilang mismatch sa resulta. Walang bahagi ng pipeline ang tahimik na pumipili ng panalo at nagtatago ng hindi pagkakasundo.
Pag-validate ng MRZ checksum
Dapat munang pumasa sa sarili nitong kuwenta ang machine-readable zone bago namin ito pagkatiwalaan.
Ang ICAO machine-readable zone sa isang pasaporte ay may mga check digit ayon sa disenyo. Vine-validate ito ng ShieldID bago ituring na maaasahan ang isang field na nabasa mula sa MRZ.
Hinahanap ng isang dedikadong detector ang MRZ, kinukuha ng isang reader ang mga karakter, at sinusukat ang resulta para sa validity laban sa sarili nitong mga checksum formula ng zone. Ang field lang na lumampas sa minimum na validity score ang pinagkakatiwalaan sa buong priyoridad; ang zone na mahina ang pagkabasa ay tinatrato nang naaayon sa halip na ipasa na parang malinis.
Barcode-first na priyoridad
Kapag nagsasapawan ang mga source, ang pinakamaaasahan ang nananaig.
Ang parehong field ay maaaring lumabas sa barcode, sa MRZ at sa nakaimprentang harap. Nilulutas ito ng ShieldID gamit ang iisang pare-parehong pagkakasunod-sunod, sa bawat pagkakataon.
- PDF417 barcode
- Passport MRZ, kapag pumasa na sa checksum nito
- Structured na pagbasa ng nakaimprentang harap
- Full-page OCR fallback
Mga dokumento ng address
Mag-upload ng pangalawang dokumento, at makakuha ng diretsong paghahambing ng address.
Kapag kailangan ng beripikasyon ang patunay ng address, nag-a-upload ang aplikante ng hiwalay na dokumento at binabasa ito ng ShieldID sa parehong paraan ng pagbasa nito sa ID.
Dumadaan sa OCR ang dokumento ng address, at ikinukumpara ang address nito sa address na nabasa mula sa ID document. Ito ay simpleng paghahambing ng text at token, hindi hiwalay na document classifier, at tumatakbo lang ito kapag hinihingi ng session at may aktwal na dokumentong ibinigay.
Redaction at paghawak ng PII
Pinoprotektahan ang na-extract na data sa parehong paraan ng mga larawan.
Ang mga structured field ay nasa tabi ng parehong mga privacy control na umiiral para sa mga larawan ng ID mismo.
Naka-encrypt ang petsa ng kapanganakan at-rest
Ang petsa ng kapanganakan ay iniimbak na naka-encrypt at-rest; hindi tatakbo ang serbisyo kung wala ang encryption key.
Binubura ang mga larawan ayon sa timer
Awtomatikong binubura ang mga nakuhang larawan ng dokumento at selfie sa loob ng maikling timer, pitong araw bilang default. Tumatakbo ang sweep sa takdang interval at muli pagkaraan ng bawat restart, kaya hindi pinapayagan ng tahimik na panahon na manatili ang isang larawan lampas sa araw na dapat na itong nawala.
On-device na redaction ng score
Kung saan ipapakita sana sa mismong telepono ng aplikante ang match o confidence figure, tinatanggal ng ShieldID ang pinagbabatayang porsyento mula sa mensaheng iyon bago ito ipakita, kaya hindi kailanman lumalabas ang raw score sa labas ng iyong account.
Mas matagal ang record kaysa sa mga larawan
Ang mga larawan ay may iskedyul. Ang katotohanang naganap ang beripikasyon, at kung ano ang natuklasan nito, ay nananatili sa iyong account — at, para sa Trust Ledger integration, bilang verified/failed na entry sa Activity Ledger (mga ledger entry para sa mga ShieldID API account: Coming soon).
Halimbawang resulta
Mga verdict kada field, sa hugis na ibinabalik ng API.
Ang mga pangalan, numero at address sa ibaba ay kathang-isip lamang para sa halimbawang ito. Ang set ng mga field, ang pinagmulan at ang mga verdict ay ang tunay na hugis ng isang resulta.
| Field | Halaga | Pinagmulan | 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"
}Mga tala sa integration
Parehong mga field, saan mo man basahin ang resulta.
Ang mga structured field ay hindi hiwalay na produkto mula sa verification session. Dumarating ang mga ito bilang bahagi ng iisang resulta.
- Ibinibigay ang mga field sa session result na kukunin mo sa pamamagitan ng API kapag natapos ang isang verification.
- Ang parehong resulta ay inihahatid sa iyong endpoint sa pamamagitan ng signed webhook kapag natapos ang verification, kaya hindi mo na kailangang mag-poll.
- Bawat field ay may nakatalagang source at sarili nitong verdict, sa parehong API result at webhook payload.
- Ang mga sandbox session ay nagbabalik ng parehong hugis ng field gaya ng production, kaya maitatayo mo ang iyong integration bago pa makabasa ng isang totoong dokumento.
Mga Tanong
Mga tuwirang sagot tungkol sa data extraction.
Tingnan mo mismo ang mga field
Magpatakbo ng sandbox verification at basahin ang structured na resulta.
Gumawa ng sandbox session, mag-scan ng dokumento gamit ang sarili mong telepono, at tingnan ang bawat field, ang source nito, at ang verdict nito sa response. Hindi kailanman binibill ang mga sandbox session.