Documentație API / INTELRADIO
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.
Capturi și transcrieri din pilotul real
Platforma /operations folosește contul cu email și parolă. Accesul la posturi, perioadă și resurse este acordat separat. Pentru integrări, administratorul emite o cheie operațională revocabilă; aceasta se transmite numai în antetul Authorization: Bearer CHEIA_TA.
| Rută | Date și permisiune |
|---|---|
GET /api/operations/session | Identitate și grantul efectiv. |
GET /api/operations/stations | Capturi, durate măsurate și coadă ASR; coverage:read. |
GET /api/operations/transcripts | Text automat cu limbă și timing ASR; transcripts:read. |
GET /api/operations/ads?status=candidate | Candidați neconfirmați; candidates:read. |
GET /api/operations/ads?status=confirmed | Numai apariții verificate pentru livrare; confirmed:read. |
GET /api/operations/export.csv | Export de candidați sau confirmări, potrivit permisiunii și filtrului status. |
GET /api/operations/captures/{id}/audio | WAV original privat, numai cu audio:read și întregul fragment în perioada acordată. |
Filtrele sunt station_id, since și until, cu fus orar și sfârșit exclusiv. Paginarea folosește limit 1–100 și offset. Un filtru nu extinde grantul. Limita este 60 citiri/minut per cont, cumulat pentru sesiuni și chei. Un snapshot mai vechi de cinci minute produce 503; lipsa datelor nu generează exemple sintetice.
demo=false indică proveniența reală a datelor, fără a certifica acuratețea ASR. Capturile fără text, coada, joburile eșuate și lipsa confirmărilor sunt vizibile separat. Pilotul scurt nu dovedește monitorizare 24/7. Cheile operaționale și cele de livrare /api/v1 sunt acordate pentru scopurile lor distincte.