Documentația API pentru parteneri

401 INVALID_TOKEN

Niciun jeton activ nu corespunde datelor de autentificare Bearer sau jetonul a fost revocat. Un antet Authorization lipsă sau formatat greșit primește tot răspunsul 401, dar numai punctul final metrics îl marchează cu acest cod. Un jeton SSP folosit pe un punct final pentru parteneri primește același răspuns.

{
  "error": "Invalid or revoked partner API token. This endpoint only accepts partner tokens, not SSP tokens.",
  "code": "INVALID_TOKEN"
}

{
  "error": "Invalid or revoked partner API token.",
  "code": "INVALID_TOKEN"
}

{
  "error": "Missing or invalid Authorization header. Expected: Bearer <token>",
  "code": "INVALID_TOKEN"
}

{
  "error": "Missing or invalid Authorization header. Expected: Bearer <token>"
}

403 PRO_PLAN_REQUIRED

Jetonul este valid, iar editorul său nu are planul Pro. Această verificare se face înaintea celei a nivelului de acces, astfel încât un jeton doar pentru citire care aparține unui editor fără planul Pro semnalează planul, nu nivelul de acces.

{
  "error": "The Pro plan is required to use the partner API.",
  "code": "PRO_PLAN_REQUIRED"
}

403 INSUFFICIENT_SCOPE

Jetonul este valid și are planul Pro, dar îi lipsește nivelul de acces metrics:write necesar pentru raportarea indicatorilor.

{
  "error": "This token is not authorised to write metrics. Required scope: metrics:write.",
  "code": "INSUFFICIENT_SCOPE"
}

403 FORBIDDEN

Notificarea aparține altui editor. Nu se înregistrează nimic.

{
  "error": "This advertisement belongs to a different publisher.",
  "code": "FORBIDDEN"
}

400 INVALID_METRICS

Corpul cererii nu este JSON valid sau cele două valori lipsesc, sunt negative ori nu sunt numere întregi. Răspunsul indică ce nu a trecut verificarea.

{
  "error": "Invalid engagement metrics",
  "code": "INVALID_METRICS",
  "issues": [
    {
      "path": "viewsCount",
      "message": "Too small: expected number to be >=0"
    }
  ]
}

{
  "error": "Invalid request body",
  "code": "INVALID_METRICS"
}

409 METRICS_NOT_APPLICABLE

Notificarea se află în afara domeniului pentru care sunt definiți indicatorii de interacțiune. Nota 15 din anexa II vizează o notificare online sau nativă pentru care s-au folosit tehnici de vizare a unui public-țintă sau tehnici de distribuire a materialelor publicitare și care a început să fie difuzată. Nu se înregistrează nimic.

{
  "error": "Engagement metrics do not apply to this notice",
  "code": "METRICS_NOT_APPLICABLE"
}

404 NOT_FOUND

Nicio notificare nu corespunde acestui PA-ID sau notificarea nu vă este încă vizibilă. Consultați secțiunea de mai sus înainte de a presupune că identificatorul este greșit.

{
  "error": "Advertisement not found",
  "code": "NOT_FOUND"
}

{
  "error": "Advertisement not found"
}

{
  "error": "Advertisement not found or not yet confirmed"
}

429 RATE_LIMITED

Limita pentru fiecare jeton a fost depășită. Răspunsul conține antetele X-RateLimit-Limit, X-RateLimit-Remaining și X-RateLimit-Reset.

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMITED",
  "limit": 1000,
  "remaining": 0,
  "reset": "2026-05-14T15:14:00.000Z"
}

{
  "error": "Rate limit exceeded",
  "limit": 1000,
  "remaining": 0,
  "reset": "2026-05-14T15:14:00.000Z"
}

Specificație care poate fi citită automat

Documentul OpenAPI 3.1 complet este disponibil la /api/docs. Conectați Postman, Swagger UI sau un generator de clienți direct la acesta, în loc să transcrieți această pagină.