Wyodrębnianie danych
API do skanowania dokumentów tożsamości z OCR, które zwraca ustrukturyzowane pola, a nie blok tekstu.
ShieldID zamienia państwowy dokument tożsamości ze zdjęciem w ustrukturyzowane dane dla każdego pola: imię i nazwisko, data urodzenia, numer dokumentu, data ważności, adres i inne, a każde z nich zawiera informację o swoim źródle i własny werdykt. API do wyodrębniania danych z dokumentów i API do weryfikacji dokumentów w jednej sesji.
Co zwracane jest w wyniku
Ustrukturyzowane pola, tam gdzie dokument faktycznie je zawiera.
Nie każdy dokument zawiera każde pole. ShieldID zwraca to, co dokument ma, i oznacza to, czego nie ma.
- Imię i nazwisko
- W postaci drukowanej oraz zakodowanej w kodzie kreskowym lub MRZ, jeśli dokument je zawiera.
- Data urodzenia
- Odczytywane z zadrukowanej strony i weryfikowane krzyżowo z kodem kreskowym oraz MRZ.
- Numer dokumentu
- Numer prawa jazdy lub numer paszportu, sprawdzany pod kątem wewnętrznej spójności, o ile format wystawcy na to pozwala.
- Data ważności
- Odczytywana z zadrukowanej strony oraz z kodu kreskowego lub MRZ.
- Adres
- Odczytywany z zadrukowanej strony i z kodu kreskowego, jeśli występuje; możliwy do porównania z osobno przesłanym dokumentem potwierdzającym adres.
- Płeć
- Odczytywane tam, gdzie dokument je drukuje lub koduje.
- Jurysdykcja wydająca
- Identyfikowany na podstawie kodu wystawcy w kodzie kreskowym, o ile dokument zawiera rozpoznawany kod i dane są dostępne.
Trzy źródła, jedno porównanie
Kod kreskowy, MRZ i drukowany awers – odczytywane celowo, a nie mieszane przypadkiem.
Każde pole jest przypisane do źródła, z którego pochodzi. Gdy dwa źródła się różnią, jest to flaga na wyniku, a nie średnia z dwóch wartości.
Kod kreskowy PDF417
Odwrotna strona północnoamerykańskiego prawa jazdy lub dowodu tożsamości jest dekodowana do ustrukturyzowanych pól AAMVA. Gdy dokument zawiera kod kreskowy, jego pola mają pierwszeństwo przed zadrukowanym awersem.
MRZ paszportu
Strefa odczytu maszynowego jest lokalizowana, odczytywana i weryfikowana zgodnie ze wzorami cyfr kontrolnych ICAO wbudowanymi w tę strefę. Minimalny wynik poprawności, sprawdzany względem tego wyniku, decyduje o tym, czy pole odczytane z MRZ w ogóle jest uznawane za wiarygodne – strefa, która nie przechodzi własnej sumy kontrolnej, nie może zastąpić czystszego źródła.
Ustrukturyzowany odczyt OCR oraz OCR całej strony awersu
Zadrukowana strona jest odczytywana z wykorzystaniem układu danego dokumentu, jeśli został rozpoznany, a w przeciwnym razie za pomocą OCR całej strony, dzięki czemu nawet nieznany dokument daje czytelne pola.
Konflikty są oznaczane, a nie uśredniane
Imię i nazwisko lub data urodzenia, które różnią się między awersem, kodem kreskowym i MRZ, są zgłaszane na wyniku jako niezgodność. Żaden etap przetwarzania po cichu nie wybiera zwycięzcy ani nie ukrywa rozbieżności.
Weryfikacja sumy kontrolnej MRZ
Strefa odczytu maszynowego musi przejść własną kontrolę matematyczną, zanim jej zaufamy.
Strefa odczytu maszynowego ICAO w paszporcie z założenia zawiera cyfry kontrolne. ShieldID weryfikuje je, zanim uzna pole odczytane z MRZ za wiarygodne.
Dedykowany detektor lokalizuje MRZ, czytnik wyodrębnia znaki, a wynik jest oceniany pod kątem poprawności względem wzorów sum kontrolnych samej strefy. Tylko pole, które osiągnie minimalny wynik poprawności, jest traktowane z pełnym priorytetem; strefa odczytana słabo jest traktowana odpowiednio, zamiast być przepuszczana tak, jakby była czysta.
Priorytet kodu kreskowego
Gdy źródła się pokrywają, wygrywa to najbardziej wiarygodne.
To samo pole może występować w kodzie kreskowym, w MRZ i na drukowanym awersie. ShieldID rozstrzyga to za każdym razem według jednej, spójnej kolejności.
- Kod kreskowy PDF417
- MRZ paszportu, po pozytywnej weryfikacji sumy kontrolnej
- Ustrukturyzowany odczyt drukowanego awersu
- Awaryjny OCR całej strony
Dokumenty potwierdzające adres
Wystarczy przesłać drugi dokument, aby otrzymać proste porównanie adresów.
Gdy weryfikacja wymaga potwierdzenia adresu, wnioskodawca przesyła osobny dokument, a ShieldID odczytuje go w taki sam sposób jak dokument tożsamości.
Dokument potwierdzający adres jest poddawany OCR, a zawarty w nim adres jest porównywany z adresem odczytanym z dokumentu tożsamości. Jest to zwykłe porównanie tekstu i tokenów, a nie osobny klasyfikator dokumentów; jest ono wykonywane tylko wtedy, gdy sesja tego wymaga i gdy dokument został faktycznie dostarczony.
Redakcja i obsługa danych osobowych (PII)
Wyodrębnione dane są chronione w taki sam sposób jak obrazy.
Pola ustrukturyzowane podlegają tym samym zabezpieczeniom prywatności, które dotyczą samych zdjęć dokumentów tożsamości.
Data urodzenia szyfrowana w spoczynku
Data urodzenia jest przechowywana w postaci zaszyfrowanej w spoczynku; usługa nie uruchomi się bez klucza szyfrowania.
Obrazy usuwane według zegara
Przechwycone obrazy dokumentu i selfie są automatycznie usuwane według krótkiego zegara, domyślnie po siedmiu dniach. Czyszczenie uruchamia się w określonych odstępach czasu oraz ponownie krótko po każdym restarcie, dzięki czemu nawet w okresie bezczynności żaden obraz nie pozostaje dłużej, niż powinien.
Redakcja wyników na urządzeniu
Tam, gdzie wartość dopasowania lub poziomu pewności zostałaby w przeciwnym razie wyświetlona na telefonie samego wnioskodawcy, ShieldID usuwa z komunikatu wartość procentową przed jego wyświetleniem, dzięki czemu surowy wynik nigdy nie jest ujawniany poza Państwa kontem.
Zapis przetrwa obrazy
Obrazy są usuwane zgodnie z harmonogramem. Informacja o tym, że weryfikacja się odbyła, oraz o jej ustaleniach pozostaje na Państwa koncie – a w przypadku integracji z Trust Ledger także jako wpis o wyniku pozytywnym/negatywnym w Activity Ledger (wpisy księgi dla kont API ShieldID: wkrótce).
Przykładowy wynik
Werdykty dla poszczególnych pól, w formacie zwracanym przez API.
Poniższe imiona i nazwiska, numery oraz adresy są zmyślone na potrzeby tego przykładu. Zestaw pól, źródła danych i werdykty odzwierciedlają rzeczywistą strukturę wyniku.
| Pole | Wartość | Źródło | Werdykt |
|---|---|---|---|
| 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"
}Uwagi dotyczące integracji
Te same pola, gdziekolwiek odczytują Państwo wynik.
Ustrukturyzowane pola nie są odrębnym produktem względem sesji weryfikacji. Docierają jako część tego samego wyniku.
- Pola są dostarczane w wyniku sesji, który pobierają Państwo przez API po zakończeniu weryfikacji.
- Ten sam wynik jest dostarczany na Państwa punkt końcowy przez podpisany webhook po zakończeniu weryfikacji, więc nie muszą Państwo cyklicznie odpytywać o wynik.
- Każde pole ma przypisane źródło i własny werdykt, zarówno w wyniku z API, jak i w ładunku webhooka.
- Sesje sandbox zwracają te same struktury pól co środowisko produkcyjne, więc mogą Państwo zbudować integrację, zanim zostanie odczytany choć jeden prawdziwy dokument.
Pytania
Rzeczowe odpowiedzi o ekstrakcji danych.
Zobaczcie Państwo pola na własne oczy
Proszę przeprowadzić weryfikację w sandbox i odczytać ustrukturyzowany wynik.
Proszę utworzyć sesję sandbox, zeskanować dokument na własnym telefonie i zobaczyć w odpowiedzi każde pole, jego źródło i werdykt. Sesje sandbox nigdy nie są rozliczane.