Dezvoltatori

CredoRisk API documentație.

Clientul solicită un raport prin API. Backend-ul dvs. apelează apoi CredoRisk API, care generează raportul standardizat și îl returnează în JSON/PDF.

Pornire rapidă

Integrare

Conectați CredoRisk la backend în câteva zile

API-ul este conceput pentru uz server-to-server: autentificare prin cheie, endpoint-uri stabile, răspunsuri JSON normalizate. Echipele de business păstrează același format CredoRisk ca în interfața web — fără a expune providerii sursă clientului final.

Chei API create și revocabile în spațiul client
Flux Franța recomandat: search → france/{siren} → uuid → PDF
Internațional: țară + identificator oficial
Erori documentate (401, 402, 422…) și timeout-uri recomandate

Creați un cont dezvoltator

Pornire rapidă — Franța (recomandat)

Raport standard API flux: aceeași logică ca și interfața web CredoRisk. Stocați uuid returnat.

# 1) Cauta in Franta dupa nume (0 credite)
curl -sS -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/standard/search?q=airbus"
# -> citeste results.resultats[].siren

# 2) Genereaza raport Franta (1 credit)
curl -sS -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/standard/france/383474814"
# -> salveaza report.uuid

# 3) Recitire completa (0 credite)
curl -sS -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/standard/report/550e8400-e29b-41d4-a716-446655440000"

# 4) PDF (0 credite)
curl -sS -H "Authorization: Bearer <api_key>" \
  -o report.pdf \
  "https://credorisk.com/api/v1/standard/report/550e8400-e29b-41d4-a716-446655440000/pdf"
      

Pentru un SIRET din 14 cifre, utilizați primele 9 cifre ca SIREN. Timeout recomandat: 60-90 s.

Raport standard API Clasic API (moștenire) API preț

Autentificare

Each request is signed with a CredoRisk API key (header Authorization: Bearer or X-API-Key). The client never sees the source provider.

Authorization: Bearer <CREDORISK_API_KEY>
or
X-API-Key: <CREDORISK_API_KEY>
          

API preț

API este gratuit. Facturarea se bazează pe rapoarte generate, cu reduceri de volum.

Vedeți prețul raportului

CredoRisk format de raport

Răspuns standardizat: company, decision, sections.directors, sections.financials, ___PH__sections. Contract stabil independent de furnizorul sursă.

Trasabilitate deplină

Toate apelurile API sunt urmărite. Rapoartele standard sunt stocate de uuid; clasic API folosește report_id.

Debit recomandat

Franța — Raport standard API

Căutați după nume, generați după SIREN, stocați UUID, citiți și descărcați PDF.

1) Caută

GET /standard/search?q=... - citiți results.resultats[] și SIREN.

2) Generație

GET /standard/france/{siren} - preluați report.uuid.

3) Readback

GET /standard/report/{uuid} - câmpuri credorisk + raw.

4) PDF

GET /standard/report/{uuid}/pdf - descărcați fără credit suplimentar.

Raport standard

Puncte finale /standard/*

GET /api/v1/standard/search?q=...

Căutați în Franța după numele companiei. Răspuns: results.resultats (lista de companii).

GET /api/v1/standard/france/{siren}

Generați sau returnați un raport complet pentru Franța. Răspuns: report.uuid, cached.

GET /api/v1/standard/report/{uuid}

Readback cu credorisk, raw, source_type.

GET /api/v1/standard/{country}/{identifier}

Raport internațional (în afara Franței).

Moştenire

Clasic API (moștenire)

Pentru Franța, preferați raportul standard API de mai sus.

POST /api/v1/companies/search

Căutați companii după țară + criterii.

curl -X POST -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"countries":"FR","name":"LA REDOUTE","city":"ROUBAIX"}' \
  "https://credorisk.com/api/v1/companies/search"

GET /api/v1/companies/{providerCompanyId}/report

Generați (sau returnați memoria cache) un raport CredoRisk.

curl -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/companies/FR30612897/report?country=FR&language=en"

GET /api/v1/reports/{reportId}

Preluați un raport stocat prin identificator.

curl -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/reports/1284"

GET /api/v1/account/credits

Returnați soldul rămas și utilizarea lunară de API.

curl -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/account/credits"

Exemplu de răspuns de raport (format CredoRisk)

{
  "report_id": 1284,
  "credits_cost": 1,
  "source": "live",
  "report": {
    "company": {
      "name": "EXEMPLE SA",
      "country": "FR",
      "status": "Active",
      "reg_no": "123456789",
      "vat_no": "FR00123456789",
      "address": {
        "street": "10 RUE EXEMPLE",
        "city": "PARIS",
        "postcode": "75001",
        "region": "ILE-DE-FRANCE"
      }
    },
    "decision": {
      "score": 72,
      "risk_band": "B",
      "credit_limit": {
        "value": 50000,
        "currency": "EUR"
      },
      "days_beyond_terms": 8
    },
    "sections": {
      "directors": [],
      "financials": [],
      "signals": []
    }
  }
}
      

Principalele coduri de eroare

401 — Cheie API lipsă sau nevalidă
402 — Credite insuficiente pentru a genera un raport live
403 — Contul nu a fost verificat
404 — Raportul nu a fost găsit
422 — Parametri nevalidi
429 — Cota lunară de API a fost atinsă
500 — Eroare internă
503 — Serviciul de căutare/date nu este configurat

Sunteți gata să testați API?

Creați un cont, generați o cheie CredoRisk API și integrați rapid generarea de rapoarte în fluxul de lucru pentru clienți.

Creează cont Vedeți prețurile