Documentație

Ce este eID Romania

eID Romania permite citirea Cărții Electronice de Identitate românești (CEI) prin NFC pe mobil sau Smart Card Reader pe desktop. Extrage toate datele personale, fotografia, semnătura și verifică autenticitatea cardului prin Passive Authentication.

Date disponibile

Metode de citire

Performanță

Aplicații eID Romania

Aplicații native gata de folosit pentru citirea cărții de identitate. Disponibile pe toate platformele.

SDK Flutter

Plugin Flutter pentru citirea cărții de identitate. O singură bază de cod pentru Android și iOS.

Instalare

Disponibil pe pub.dev

Setup Android

Adaugă repository-ul în android/settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://europe-west1-maven.pkg.dev/eid-romania/eid-romania-sdk") }
    }
}

Exemplu

import 'package:romanian_eid_sdk/romanian_eid_sdk.dart';

await RomanianEidSdk.initialize('LICENSE_KEY');

final result = await RomanianEidSdk.readIDCard(
  can: '123456',
  pin: '1234',
);

print('Nume: ${result.fullName}');
print('CNP: ${result.cnp}');
print('Adresă: ${result.permanentAddress}');

Exemplu complet: eIDRomania-Flutter-Example

SDK React Native

Modul React Native cu TypeScript bindings pentru Android și iOS.

Instalare

Exemplu

import EIDReader from 'react-native-romanian-eid-sdk';

await EIDReader.initialize('LICENSE_KEY');

const result = await EIDReader.readIDCard({ can: '123456' });
console.log('Nume:', result.fullName);
console.log('CNP:', result.cnp);

SDK Android Nativ

SDK Kotlin/Java pentru integrare directă în aplicații Android native.

Instalare (Gradle)

// settings.gradle.kts — no credentials required
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://europe-west1-maven.pkg.dev/eid-romania/eid-romania-sdk") }
    }
}

// app/build.gradle.kts
dependencies {
    implementation("com.up2date.eidromania:eidromania-android-sdk:1.0.6")
}

Exemplu complet: eIDRomania-Android-Example

SDK iOS Nativ

XCFramework Swift pentru integrare directă în aplicații iOS/iPadOS native.

Info.plist

<key>NFCReaderUsageDescription</key>
<string>Citire carte de identitate electronică</string>
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
    <string>A0000002471001</string>
    <string>A000000077030C60000000FE00000500</string>
    <string>E828BD080FA000000167454441544100</string>
</array>

SDK-ul iOS se livrează ca XCFramework. Contactează-ne pentru acces.

SDK .NET (C#)

SDK pentru aplicații desktop .NET — WPF, WinForms, Blazor, console apps. Folosește cititoare PC/SC (contact sau NFC).

Instalare

Disponibil pe NuGet.org

Exemplu

using EIDRomania.SDK;

using var sdk = new EIDRomaniaSdk();
sdk.Initialize("LICENSE_KEY", "com.yourcompany.app");

var readers = sdk.AvailableReaders;
sdk.SetActiveReader(0);

var card = await sdk.ReadAsync("123456", "1234");

Console.WriteLine($"Nume: {card.GivenNames} {card.Surname}");
Console.WriteLine($"CNP: {card.Cnp}");
Console.WriteLine($"Adresă: {card.PermanentAddress}");
Console.WriteLine($"Autentic: {card.AuthenticationResult}");

Exemplu complet: eIDRomania-CSharp-Example

SDK Java

SDK pentru aplicații Java desktop — Swing, JavaFX, Spring Boot, console apps. Folosește cititoare PC/SC.

Instalare (Gradle)

// build.gradle.kts — no credentials required
repositories {
    mavenCentral()
    maven { url = uri("https://europe-west1-maven.pkg.dev/eid-romania/eid-romania-sdk") }
}

dependencies {
    implementation("com.up2date.eidromania:eidromania-desktop-sdk:1.0.6")
}

Exemplu

import com.up2date.eidromania.desktopsdk.api.*;

EIDRomaniaDesktopSDK sdk = new EIDRomaniaDesktopSDK();
sdk.initialize("LICENSE_KEY", "com.yourcompany.app");

sdk.setActiveReader(0);
EIDCard card = sdk.read("123456", "1234");

System.out.println("Nume: " + card.getGivenNames() + " " + card.getSurname());
System.out.println("CNP: " + card.getCnp());

Exemplu complet: eIDRomania-Java-Example

Serviciu System Tray (API Local)

Aplicație desktop care rulează în background (system tray) și expune un API HTTP pe localhost:8765. Permite integrarea citirii eID în orice aplicație web prin JavaScript.

Caracteristici

• API REST local pe localhost:8765
• Integrare JavaScript — fetch API sau axios din orice framework web
• Dialog grafic pentru introducere CAN/PIN
• Cititoare contact și NFC — funcționează pe localhost, fără autentificare

Contactează-ne pentru documentația completă a API-ului local.