https://api.eurodebt.eu/api/{version}

1. Obțineți o cheie API din tabloul de bord Eurodebt. Navigați la Management > Settings > API Keys și faceți clic pe „Create API Key”.
2. Includeți cheia API în toate cererile prin intermediul x-api-key antet
3. Trimiteți cereri de verificare și primiți rezultate prin webhook-uri sau sondaje

Toate solicitările API necesită autentificare folosind o cheie API. Includeți cheia API în x-api-key antet.

x-api-key: your-api-key-here

Cheile API au permisiuni care controlează accesul la diferite endpoint-uri:

• cititAcces pentru a recupera cereri de verificare, rapoarte și date de utilizare
• scriePosibilitatea de a trimite noi solicitări de verificare

API-ul are o rată limitată la 100 cereri pe minut per cheie API Când rata este limitată, veți primi un 429 Too Many Requests raspuns.

Anteturile cu limita de viteză sunt incluse în toate răspunsurile:

• RateLimit-LimitNumărul maxim de solicitări per fereastră
• RateLimit-RemainingCereri rămase în fereastra curentă
• RateLimit-Reset: Momentul la care limita de rată se resetează (timestamp Unix)

Webhook-urile vă permit să primiți notificări în timp real atunci când au loc evenimente în contul dvs. În loc să solicitați actualizări prin API, furnizați o adresă URL, iar Eurodebt va trimite solicitări HTTP POST către acea adresă URL atunci când au loc evenimente relevante.

Cum funcționează Webhook-urile

1. Configurați: Furnizeaza un webhookUrl la trimiterea unei solicitări (de exemplu, solicitare de verificare, generare PDF)
2. Evenimentul are locCând operațiunea se finalizează sau eșuează, Eurodebt trimite o solicitare POST la adresa URL a dvs.
3. EtapeServerul dumneavoastră primește sarcina utilă, verifică semnătura și procesează datele
4. recunoașteReturnați un cod de stare 2xx în termen de 10 secunde pentru a confirma primirea

Securitate Webhook (Verificare semnătură)

Toate cererile webhook sunt semnate folosind HMAC-SHA256 cu secretul webhook al cheii API. Semnătura este inclusă în X-Eurodebt-Signature antet.

Format antet: sha256=<hex-encoded-signature>

Node.js / Express:

const crypto = require('crypto');

app.post('/webhook', (req, res) => {
  const signature = req.headers['x-eurodebt-signature'];
  
  const expected = 'sha256=' + crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(JSON.stringify(req.body))
    .digest('hex');

  if (signature !== expected) {
    return res.status(401).send('Invalid signature');
  }

  res.status(200).send('OK');
});

Python / Flask:

import hmac, hashlib

@app.route('/webhook', methods=['POST'])
def webhook():
    signature = request.headers.get('X-Eurodebt-Signature', '')
    expected = 'sha256=' + hmac.new(WEBHOOK_SECRET.encode(), request.data, hashlib.sha256).hexdigest()

    if not hmac.compare_digest(signature, expected):
        return 'Invalid signature', 401

    return 'OK', 200

PHP:

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_EURODEBT_SIGNATURE'] ?? '';
$expected = 'sha256=' . hash_hmac('sha256', $payload, WEBHOOK_SECRET);

if (!hash_equals($expected, $signature)) {
    http_response_code(401);
    exit('Invalid signature');
}

http_response_code(200);

Anteturi Webhook

Fiecare solicitare webhook include următoarele anteturi:

Politica de reîncercare a Webhook-ului

Dacă livrarea webhook-ului eșuează, sistemul implementează un mecanism automat de reîncercare:

1. Încercări imediatePână la 3 încercări cu întârzieri de 1s, 5s și 30s
2. Reîncercări programateDacă încercările imediate eșuează, webhook-ul este programat pentru încercări în fundal la intervale crescătoare:
   • 5 minute, 15 minute, 30 de minute, 1 oră, 2 ore, 4 ore, 8 ore
3. Numărul maxim de încercăriDupă 10 încercări în total, webhook-ul este marcat ca eșuat

Erori care pot fi reîncercate:

• Expirări ale rețelei și erori de conexiune
• Erori ale serverului HTTP 5xx

Erori care nu pot fi reîncercate (fără alte încercări):

• Erori ale clientului HTTP 4xx (cu excepția 429)

Starea livrării Webhook-ului

Puteți verifica starea livrării webhook-ului prin preluarea cererii de verificare:

Note importante

• Răspundeți rapidReturnează un status 2xx în termen de 10 secunde pentru a confirma primirea
• Verificați semnăturileValidați întotdeauna X-Eurodebt-Signature antet

1. Trimite cererea → POST /verification/submit Returnează requestId
2. Prelucrare → Verificarea este procesată
3. Finalizare tranzactiei → Webhook-ul este trimis (dacă este configurat) cu status: "completed" or status: "rejected"
4. Preluare raport → Utilizați verificationId din webhook sau sondaj GET /verification/request/{id}

Mai multe puncte finale acceptă o language parametru pentru câmpuri traductibile.

Toate erorile returnează o structură JSON consistentă:

{
  "error": {
    "type": "ERROR_TYPE",
    "message": "Human-readable error description"
  }
}

Puncte finale pentru trimiterea și recuperarea cererilor și rapoartelor de verificare

Puncte finale pentru monitorizarea utilizării contului și a cotelor

Apeluri de tip webhook trimise de Eurodebt la finalizarea operațiunilor. Fiecare tip de webhook are propria structură de payload documentată mai jos.