Credite API

API-ul public SCOPO folosește un model de credite lunare (similar consumului ListaFirme, adaptat la intelligence SEAP).

Eligibilitate

Plan	Acces API	Credite incluse / lună
Free	—	—
Starter	—	—
Activ	—	—
Consultant	Da	1.500

Creditele se resetează la începutul fiecărei luni calendaristice (fără cumulare în Faza 0 Beta).

Cost per operațiune

Operațiune	Credite	Regulă
GET /api/v1/tenders	1 × tender returnat	Taxare doar pe data[] livrat
GET /api/v1/tenders/:id/score	2	Scor + factor breakdown
GET /api/v1/export/tenders	1 × rând exportat	Max conform limit (1–1000)
POST /api/v1/reports/:companyId/pdf	10	Doar la job completed
Webhook tender.matched	0	Push inclus în abonament
CRUD webhooks / management chei	0	Setup

Răspuns cu credite

Răspunsurile JSON includ meta.credits:

{
  "data": [],
  "meta": {
    "credits": {
      "cost": 20,
      "remaining": 1480,
      "period_ends_at": "2026-07-01T00:00:00+03:00"
    }
  }
}

Antete HTTP:

• X-API-Credits-Cost
• X-API-Credits-Remaining

Epuizare credite

Când soldul este insuficient:

{
  "statusCode": 402,
  "code": "API_CREDITS_EXHAUSTED",
  "message": "Creditele API incluse în planul Consultant au fost epuizate pentru această lună.",
  "credits_remaining": 0,
  "credits_required": 20,
  "period_ends_at": "2026-07-01T00:00:00+03:00"
}

Pachete suplimentare de credite — disponibile în Faza 2 (Stripe).

Rate limits tehnice

Pe lângă credite, se aplică limite anti-abuz:

Grup endpoint	Limită
General (/tenders, webhooks)	60 / minut
Export	20 / oră
PDF reports	10 / oră

La depășire: 429 RATE_LIMIT_EXCEEDED cu retry_after_seconds.