Documentazione API SSP
API di piattaforma lato offerta per piattaforme pubblicitarie programmatiche
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10.000 richieste al minuto
Limite di velocità applicato per token SSP
/online-advertisement/{PAID}📊 Formato etichetta compatto
Questo endpoint restituisce un'etichetta di trasparenza compatta e conforme all'UE, adatta per la visualizzazione insieme agli annunci pubblicitari online. Funziona solo per annunci pubblicitari con mezzo = "online".
curl -X GET "https://polads.eu/api/v1/online-advertisement/ABC12" \
-H "Authorization: Bearer YOUR_SSP_TOKEN" \
-H "Accept: application/json"{
"text": "Politisk Reklame - ACME Corp - Folketingsvalg - polads.eu/ABC12",
"link": "https://polads.eu/ABC12",
"PAID": "ABC12"
}Visualizza l'etichetta sulla tua piattaforma:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Formato intestazione
Authorization: Bearer YOUR_SSP_TOKENFormato token
Stringa esadecimale da 64 caratteri (entropia a 256 bit)
Gestione dei token I token
SSP sono gestiti solo dagli amministratori di sistema. Contatta il tuo amministratore per ottenere un token.
Non si applica alcun piano
Un token SSP è rilasciato a un integratore e non a un editore, quindi non appartiene ad alcun account editore e non c’è alcun piano da verificare. A differenza dell’API partner, qui nulla dipende da un abbonamento. Un token partner è rifiutato su questo endpoint con 401, e un token SSP è rifiutato allo stesso modo sugli endpoint partner.
Quando l’endpoint restituisce 404
L’annuncio è risolto con la stessa regola di visibilità del registro pubblico. Un annuncio non ancora confermato, che l’editore non ha ancora approvato, o la cui data di inizio pubblicazione è ancora futura restituisce 404. Un 404 non dimostra quindi che un PA-ID sia errato.
L’endpoint qui sopra restituisce il testo dell’etichetta su una riga, per un’etichetta che disegna la vostra piattaforma. Il contrassegno restituisce un avviso interattivo già composto, che collocate accanto all’annuncio in una cornice. Entrambi descrivono lo stesso avviso di trasparenza.
Un URL per ogni versione
I comandi della dimostrazione corrispondono uno a uno a questi parametri, quindi può scegliere nella pagina dimostrativa e copiare l'URL che vede.
# Contrassegno d'angolo, solo il segno
GET https://polads.eu/badge/{PA-ID}
# Contrassegno d'angolo con la dicitura
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Striscia di identificazione sempre visibile
GET https://polads.eu/badge/{PA-ID}?layout=labelCosa fa ciascun parametro e cosa significa ometterlo
layout=label seleziona la striscia, senza di esso compare il contrassegno d'angolo. variant=labelled mostra la dicitura sul contrassegno chiuso, senza di esso resta solo il segno. w e h dichiarano lo spazio in cui si trova il contrassegno e decidono come si adatta quando lo spazio è poco. Se li omette, il contrassegno presume di avere spazio, il che è corretto per i formati standard.
hover=0 serve alla dimostrazione, non alla sua pagina
Impone la resa senza puntatore perché la dimostrazione possa mostrare la versione tattile in un browser da scrivania. Il contrassegno reale verifica da sé il dispositivo. Fissandolo, invia la versione sbagliata a ogni visitatore il cui dispositivo dice il contrario.
L’ascoltatore del ridimensionamento è obbligatorio
Il contrassegno d’angolo si carica a 32 per 32 per coprire il meno possibile della creatività, poi chiede spazio alla pagina quando si apre. Senza l’ascoltatore non può aprirsi affatto. La fascia è più tollerante e viene tagliata solo su larghezze strette.
Disponibile solo per un avviso pubblicato
Il contrassegno viene servito quando l’avviso è confermato, approvato dall’editore e superata la data di inizio. Un PA-ID sotto embargo o non approvato risponde 404 di proposito, non per un difetto.
Apri la dimostrazione interattiva e copia il codice di incorporamento
401 Non autorizzato
{ "error": "Invalid or revoked SSP API token." }400 Richiesta non valida
L’annuncio è stato trovato, ma il suo mezzo non è online. La risposta restituisce il valore reale del mezzo, per esempio print. Un PA-ID mancante o sconosciuto restituisce invece 404.
404 Non trovato
{ "error": "Advertisement not found" }429 Limite di velocità superato
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2025-01-15T10:30:00.000Z"
}Questa è la versione API v1, e ogni risposta lo dichiara in un’intestazione X-API-Version. Le modifiche non retrocompatibili escono sotto un nuovo percorso anziché modificare questo. Un endpoint v1 non verrà disattivato senza un’intestazione Deprecation con almeno 90 giorni di anticipo, secondo la RFC 8594.
Specifica leggibile da una macchina
Il documento OpenAPI 3.1 completo è servito su /api/docs. Puntate Postman, Swagger UI o un generatore di client direttamente lì anziché ricopiare questa pagina.
https://polads.eu/api/docs