API SPEC · V1 · GADEVELOPER REFERENCE

    API pentru dezvoltatori

    API REST pentru screening AML

    Integrați screeningul de sancțiuni, PEP, liste de supraveghere penală, media adversă și KYB/UBO direct în procesele dumneavoastră de onboarding, monitorizare și tranzacții. API-ul este live: autentificați-vă cu o cheie API și apelați același motor de screening folosit de portal.

    API v1 este live

    Endpoint-urile sunt disponibile publicului larg, cu autentificare prin cheie API și limite per plan. Explorați fiecare endpoint în documentația OpenAPI interactivă de la /api/v1/docs.

    §01Ghid rapid de pornire

    01 / 05
    STEP 01

    1. Creați o cheie API

    Creați o cheie API cu permisiuni definite din panoul de control, sau generați una programatic folosind tokenul bearer al contului, pentru cereri server-to-server.

    curl
    curl -X POST https://screenveritai.com/api/v1/keys \
      -H "Authorization: Bearer <SUPABASE_JWT>" \
      -H "Content-Type: application/json" \
      -d '{"name":"server-key","permissions":["search:read","search:write"]}'
    STEP 02

    2. Rulați prima căutare

    Trimiteți o entitate folosind header-ul X-API-Key. API-ul returnează un id de căutare pe care îl recuperați după finalizarea procesării.

    curl
    curl -X POST https://screenveritai.com/api/v1/search \
      -H "X-API-Key: <YOUR_API_KEY>" \
      -H "Content-Type: application/json" \
      -d '{"entity_name":"Acme Ltd","entity_type":"company","search_type":"full_search"}'
    STEP 03

    3. Trimiteți o procesare în masă

    Trimiteți un fișier CSV/XLSX pentru a verifica mai multe entități într-o singură procesare, apoi recuperați rândurile sau exporturile după finalizarea procesării.

    curl
    curl -X POST https://screenveritai.com/api/v1/batch \
      -H "X-API-Key: <YOUR_API_KEY>" \
      -F "file=@entities.csv"

    §02Endpoint-uri principale

    02 / 05
    EP 01ENDPOINT

    POST /api/v1/search

    Creează o cerere de screening pentru o singură entitate. Returnează un id de căutare și statusul procesării. Endpoint-urile de cont, acoperire și stare sunt disponibile tot sub /api/v1.

    Autentificare: X-API-Key (search:write)

    EP 02ENDPOINT

    POST /api/v1/batch

    Trimiteți fișiere CSV/XLSX pentru screening de volum mare, apoi recuperați rândurile sau exporturile după finalizarea procesărilor.

    Autentificare: X-API-Key (batch:write)

    EP 03ENDPOINT

    POST /api/v1/keys

    Creați și gestionați acreditări API cu permisiuni definite, limite adaptate planului și urmărirea utilizării.

    Autentificare: token Bearer (cont)

    §03De ce folosesc echipele acest API

    03 / 05
    • O singură integrare pentru screening de sancțiuni, PEP, liste de supraveghere penală, media adversă și KYB/UBO
    • Autentificare prin cheie API, cu header-ul X-API-Key, și chei cu permisiuni definite pentru acces cu privilegii minime
    • Limite per plan, cu jurnalizarea utilizării pentru guvernanță și control al costurilor
    • Endpoint-uri de căutare, procesare în masă, chei, cont, acoperire și stare, toate sub /api/v1
    • Documentație OpenAPI interactivă la /api/v1/docs, plus o schemă OpenAPI care poate fi citită automat
    • Rezultate structurate, potrivite pentru jurnale de audit, dosare de caz și decizii ulterioare

    §05Întrebări frecvente API

    05 / 05
    Q01

    Cum autentific cererile către API?

    Cererile de screening către /api/v1/search și /api/v1/batch se autentifică printr-o cheie API trimisă în header-ul X-API-Key. Creați chei din panoul de control sau programatic prin /api/v1/keys, după autentificarea cu tokenul bearer al contului.

    Q02

    API-ul este disponibil publicului larg?

    Da. API v1 este live și disponibil publicului larg. Autentificați-vă cu o cheie API, apelați endpoint-urile de căutare, procesare în masă și gestionare a cheilor, și explorați totul în documentația OpenAPI interactivă de la /api/v1/docs.

    Q03

    Pot restrânge permisiunile unei chei API?

    Da. Cheile acceptă permisiuni precum search:read, search:write, batch:read și batch:write, astfel încât să puteți impune acces cu privilegii minime pentru fiecare integrare.

    Q04

    Ce limite de rată se aplică?

    Limitele de rată sunt alocate pe nivel de API și aplicate per cheie API — nivelul reglementează debitul cererilor, nu facturarea. Header-ele de răspuns includ limita, cota rămasă și momentul resetării, pentru a putea temporiza cererile în mod controlat.

    Q05

    Unde pot testa rapid endpoint-urile?

    Folosiți documentația interactivă de la /api/v1/docs pentru testare Swagger și /api/v1/redoc pentru documentație de tip referință. Schema OpenAPI este disponibilă la /api/v1/openapi.json.