Documentație
Tot ce ai nevoie pentru a integra citirea eID
Începe Aici
Bine ai venit la documentația eID Romania. Acest ghid te va ajuta să integrezi citirea Cărții Electronice de Identitate românești în aplicațiile tale.
Alege între soluția SaaS (start rapid, plătești per citire) sau On-Premise (aplicații White Label, citiri nelimitate).
Start Rapid SaaS
- Creează un cont
- Achiziționează un pachet SaaS
- Generează un token de acces din panoul tău
- Descarcă aplicațiile eID Romania (Android, iOS, Desktop)
- Scanează codul QR din panou cu aplicația și începe să citești cărți eID
Securitate maximă: Datele citite de pe card sunt criptate pe telefon/desktop și trimise direct la serverul tău. Nu salvăm nicio informație pe serverele noastre.
Soluție On-Premise
Pentru soluția On-Premise (SDK + aplicații White Label cu brandul tău), contactează-ne pentru documentație dedicată și suport pentru implementare.
SaaS vs On-Premise
Soluție SaaS
Start rapid, plătești per citire
- Aplicații gata de folosit (Android, iOS, Desktop)
- Aplicații branded eID Romania
- Acces API pentru integrare
- Date trec prin serverele noastre (proxy)
- Plătești per citire (pachete flexibile)
Soluție On-Premise
Control total, citiri nelimitate
- SDK Android & iOS pentru dezvoltatori
- Aplicații White Label (Android, iOS, Desktop)
- Serviciu System Tray cu API local
- Date direct la serverul tău (nu cloud)
- Citiri nelimitate (licență one-time)
Autentificare prin Token & QR Code
SaaS - Sistem Token & QR Code
Pentru soluția SaaS, autentificarea se face simplu și rapid prin scanare cod QR:
- Generezi un token unic din panoul de control
- Tokenul generează automat un cod QR
- Scanezi codul QR cu aplicația eID Romania (Android/iOS/Desktop)
- Aplicația se conectează automat și securizat la contul tău
- Datele citite sunt criptate și trimise direct la serverul tău specificat
🔒 Garanție de Confidențialitate
- ✓ Datele sunt criptate pe dispozitiv (telefon/desktop)
- ✓ Transmisie securizată direct către serverul tău
- ✓ NU salvăm nicio informație de pe card pe serverele noastre
- ✓ Compliance complet GDPR
On-Premise - Fără Cloud
Pentru SDK-uri (Android & iOS) în pachetul On-Premise, poți configura comunicarea directă cu serverul tău fără a folosi serviciile noastre cloud. Datele nu trec niciodată prin serverele eID Romania.
Platforme Disponibile - Soluție Completă
eID România oferă suită completă de aplicații pentru toate platformele majore:
Android
- • SDK (doar On-Premise)
- • Aplicație SaaS/White Label
- • Citire NFC
- • Android 8.0+
iOS
- • SDK (doar On-Premise)
- • Aplicație SaaS/White Label
- • Citire NFC (CoreNFC)
- • iOS 13+
Desktop
- • Aplicație standalone/White Label
- • Interfață grafică intuitivă
- • Cititoare PC/SC (contact + NFC)
- • Windows/macOS/Linux
System Tray
- • NOU! Serviciu background
- • API HTTP localhost:8765
- • Integrare web (JavaScript)
- • Windows/macOS/Linux
Suită Completă: Oferim aplicații native pentru toate platformele majore - Android, iOS, Windows, macOS și Linux. Atât soluție SaaS cât și On-Premise (White Label) disponibile.
SDK Android & iOS
SDK-urile Android și iOS oferă integrare ușoară pentru citirea Cărților Electronice de Identitate românești. Disponibile doar în pachetul On-Premise.
Cerințe
- Android: 8.0 (API 26) sau mai nou
- NFC: Dispozitiv cu suport NFC activat
- Permissions: NFC + Camera (pentru scanare QR)
Documentație SDK
Documentația completă pentru SDK-uri (instalare, configurare, exemple de cod) este disponibilă pentru clienții On-Premise după achiziționarea licenței. Contactează-ne pentru acces.
Performanță
- Citire doar text: 3-5 secunde
- Citire cu imagini: 8-12 secunde
Acces Restricționat: SDK-urile Android și iOS sunt disponibile doar în pachetul On-Premise. Pentru soluția SaaS, folosește aplicațiile gata făcute cu autentificare prin QR code.
Serviciu System Tray cu API Local
Serviciul System Tray este o aplicație care rulează în background (system tray) pe Windows/macOS/Linux și expune un API local HTTP pe localhost:8765 pentru integrare în aplicații web.
Caracteristici
- API REST local pe localhost:8765
- Integrare simplă JavaScript - folosește fetch API sau axios din orice framework web
- Dialog grafic pentru introducere CAN/PIN și selecție cititor
- Suport cititoare carduri - funcționează cu cititoare contact (chip) și NFC/contactless
- Securitate prin limitare - funcționează doar pe localhost, fără autentificare necesară
Platforme Suportate
Caracteristici API Local
- ✓ Health Check - verifică dacă serviciul rulează
- ✓ Inițiere Citire - deschide dialog pentru utilizator și returnează date complete
- ✓ WebSocket - updates în timp real (opțional)
Documentație Completă
Documentația detaliată pentru API local, inclusiv endpoint-uri complete și exemple de integrare, este disponibilă pentru clienții On-Premise. Contactează-ne pentru acces.
Notă Importantă: Serviciul System Tray este disponibil doar în pachetul On-Premise. Contactează-ne pentru documentație completă și suport pentru implementare.
Performanță și Limitări
- Timp citire fără imagini: 3-5 secunde
- Timp citire cu imagini (NFC): 8-12 secunde
- Cititoare contact (chip): NU pot citi imaginile (limitare EAC)
- Cititoare NFC: Pot citi toate datele inclusiv fotografii și semnături
- Concurență: 1 card la un moment dat (limitare hardware)
- Timeout dialog: 60 secunde (utilizatorul poate anula)
Ai Nevoie de Ajutor?
Documentația completă (API, SDK-uri, exemple de cod) este disponibilă pentru clienți după înregistrare. Pentru soluția On-Premise, oferim suport dedicat și documentație extinsă.
SaaS - Start Rapid
- ✓ Scanare QR code pentru conectare
- ✓ Aplicații gata de folosit
- ✓ Datele NU sunt salvate pe serverele noastre
On-Premise - Control Total
- ✓ SDK-uri complete + documentație
- ✓ Aplicații White Label
- ✓ Suport dedicat implementare