Documentație API / RADIOINTEL
Date pentru sistemele autorizate.
Acces în citire, separat pe cont, cu posturi, branduri și perioadă acordate explicit. Cheile nu se includ în URL sau în fișiere publice.
Autentificare
Folosește HTTPS și antetul Authorization: Bearer CHEIA_TA. Cheia se acordă de administrator și poate fi revocată. Un cont fără permisiuni nu primește automat acces la toate sursele sau brandurile.
curl https://radio.megapromoting.com/api/v1/whoami \ -H 'Authorization: Bearer CHEIA_TA'
Resurse în citire
| Rută | Rol |
|---|---|
GET /api/v1/whoami | Contul și permisiunile efective. |
GET /api/v1/ads | Apariții confirmate în scope-ul contului. |
GET /api/v1/reports/summary | Agregări pe datele permise. |
GET /api/v1/coverage | Acoperirea surselor acordate, cu limite și proveniență. |
Filtre și limite
since și until sunt ISO 8601 cu fus orar; sfârșitul este exclusiv. Fără filtre, perioada este maximum ultimele 7 zile, restrânse la perioada acordată contului; intervalul maxim al unei cereri este 31 de zile. Un filtru nu poate extinde perioada contului. station_id și brand_id sunt opționale pentru apariții și sumar, în scope-ul contului.
Paginare: limit între 1 și 100, implicit 50; offset între 0 și 100000, implicit 0. Limita este 60 de cereri pe minut pentru fiecare cheie, în această instanță. Un 429 include Retry-After. Permisiunile sunt ads:read, reports:read și coverage:read.
Câmpuri și proveniență
O apariție conține id, station_id, station_name, ad_started_at, ad_ended_at, duration_seconds, duration_precision, review_state și lista brands. Datele de timp sunt UTC cu fus orar. duration_precision=human_confirmed indică limite revizuite; clasificarea confirmată singură nu certifică durata.
snapshot_exported_at arată momentul exportului aprobat. Acoperirea numără numai capturile asociate datelor acordate contului: nu măsoară funcționarea continuă a postului. Un răspuns gol nu este o demonstrație și nu dovedește absența reclamelor.
Reguli de integrare
Rezultatele sunt filtrate înainte de agregare și paginare. Înregistrările unui alt cont nu devin vizibile prin schimbarea filtrului sau identificatorului. Audio-ul, transcriptul brut, căile private și consola de administrare nu sunt resurse publice ale API-ului client.
Absența unei înregistrări confirmate nu dovedește că nu s-a difuzat reclamă. Verifică perioada, acoperirea, prospețimea sursei și limitele datelor. Folosește o cheie separată pentru fiecare integrare; nu o pune în analytics, capturi de ecran sau repository.
Erori și acces
401: cheia lipsește, este invalidă sau revocată. 403: contul nu are permisiunea resursei. 404: filtrul nu aparține resurselor acordate. 422: filtre invalide. 429: limită de cereri. 503: sursa sau politica nu este disponibilă. Limitele și scope-ul se confirmă la configurarea contului.