Τεκμηρίωση API SSP
API πλατφόρμας πλευράς προσφοράς για προγραμματιστικές διαφημιστικές πλατφόρμες
https://polads.eu/api/v1GET /online-advertisement/{PAID}
10.000 αιτήματα ανά λεπτό
Επιβάλλεται όριο τιμής ανά διακριτικό SSP
/online-advertisement/{PAID}📊 Μορφή συμπαγούς ετικέτας
Αυτό το τελικό σημείο επιστρέφει μια συμπαγή, συμβατή με την ΕΕ ετικέτα διαφάνειας, κατάλληλη για προβολή μαζί με διαδικτυακές διαφημίσεις. Λειτουργεί μόνο για διαφημίσεις με μέσο = "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"
}Εμφάνιση της ετικέτας στην πλατφόρμα σας:
<a href="[link]" target="_blank" rel="noopener">
[text]
</a>Μορφή κεφαλίδας
Authorization: Bearer YOUR_SSP_TOKENΜορφή διακριτικού
Δεκαεξαδική συμβολοσειρά 64 χαρακτήρων (εντροπία 256 bit)
Διαχείριση διακριτικών Η διαχείριση των διακριτικών
SSP γίνεται μόνο από διαχειριστές συστήματος. Επικοινωνήστε με τον διαχειριστή σας για να λάβετε ένα διακριτικό.
Κανένα πρόγραμμα δεν ισχύει
Ένα διακριτικό SSP εκδίδεται σε ενσωματωτή και όχι σε εκδότη, οπότε δεν ανήκει σε κανέναν λογαριασμό εκδότη και δεν υπάρχει πρόγραμμα προς έλεγχο. Σε αντίθεση με το API συνεργατών, εδώ τίποτα δεν εξαρτάται από συνδρομή. Ένα διακριτικό συνεργάτη απορρίπτεται σε αυτό το τελικό σημείο με κωδικό 401, και ένα διακριτικό SSP απορρίπτεται με τον ίδιο τρόπο στα τελικά σημεία συνεργατών.
Πότε το τελικό σημείο επιστρέφει 404
Η διαφήμιση εντοπίζεται με τον ίδιο κανόνα ορατότητας με το δημόσιο μητρώο. Μια διαφήμιση που δεν έχει ακόμη επιβεβαιωθεί, που ο εκδότης δεν έχει ακόμη εγκρίνει, ή της οποίας η ημερομηνία έναρξης δημοσίευσης βρίσκεται ακόμη στο μέλλον, επιστρέφει 404. Επομένως ο κωδικός 404 δεν αποδεικνύει ότι ένα PA-ID είναι λανθασμένο.
Το παραπάνω τελικό σημείο επιστρέφει το κείμενο της επισήμανσης σε μία γραμμή, για επισήμανση που σχεδιάζει η δική σας πλατφόρμα. Το σήμα επιστρέφει μια έτοιμη, διαδραστική ανακοίνωση, την οποία τοποθετείτε δίπλα στη διαφήμιση μέσα σε πλαίσιο. Και τα δύο περιγράφουν την ίδια ανακοίνωση διαφάνειας.
Μία διεύθυνση URL ανά έκδοση
Τα χειριστήρια της επίδειξης αντιστοιχούν ένα προς ένα σε αυτές τις παραμέτρους, άρα μπορείτε να επιλέξετε στη σελίδα επίδειξης και να αντιγράψετε τη διεύθυνση που βλέπετε.
# Σήμα γωνίας, μόνο το σήμα
GET https://polads.eu/badge/{PA-ID}
# Σήμα γωνίας με κείμενο
GET https://polads.eu/badge/{PA-ID}?variant=labelled
# Μόνιμα ορατή λωρίδα σήμανσης
GET https://polads.eu/badge/{PA-ID}?layout=labelΤι κάνει κάθε παράμετρος και τι σημαίνει η παράλειψή της
Το layout=label επιλέγει τη λωρίδα, χωρίς αυτό εμφανίζεται το σήμα γωνίας. Το variant=labelled δείχνει το κείμενο στο κλειστό σήμα, χωρίς αυτό μένει μόνο το σήμα. Τα w και h δηλώνουν τον χώρο όπου βρίσκεται το σήμα και καθορίζουν πώς προσαρμόζεται σε στενό χώρο. Αν τα παραλείψετε, το σήμα θεωρεί ότι έχει χώρο, κάτι που ισχύει για τα τυπικά μεγέθη.
Το hover=0 αφορά την επίδειξη, όχι τη σελίδα σας
Επιβάλλει την εμφάνιση χωρίς κατάδειξη, ώστε η επίδειξη να δείχνει την έκδοση αφής σε πρόγραμμα περιήγησης υπολογιστή. Το πραγματικό σήμα ελέγχει το ίδιο τη συσκευή. Αν το καθηλώσετε, στέλνετε τη λάθος έκδοση σε κάθε επισκέπτη του οποίου η συσκευή λέει το αντίθετο.
Ο ακροατής μεγέθους είναι υποχρεωτικός
Το γωνιακό σήμα φορτώνει σε 32 επί 32 ώστε να καλύπτει όσο το δυνατόν λιγότερο από το δημιουργικό, και όταν ανοίγει ζητά χώρο από τη σελίδα. Χωρίς τον ακροατή δεν μπορεί να ανοίξει καθόλου. Η λωρίδα επισήμανσης είναι πιο ανεκτική και περικόπτεται μόνο σε στενά πλάτη.
Διαθέσιμο μόνο για δημοσιευμένη ανακοίνωση
Το σήμα παρέχεται όταν η ανακοίνωση είναι επιβεβαιωμένη, εγκεκριμένη από τον εκδότη και έχει περάσει η ημερομηνία έναρξής της. Ένα PA-ID υπό απαγόρευση ή χωρίς έγκριση απαντά 404 σκόπιμα, όχι λόγω σφάλματος.
Ανοίξτε τη διαδραστική επίδειξη και αντιγράψτε τον κώδικα ενσωμάτωσης
401 Μη εξουσιοδοτημένο
{ "error": "Invalid or revoked SSP API token." }400 Εσφαλμένο αίτημα
Η διαφήμιση βρέθηκε, αλλά το μέσο της δεν είναι online. Η απόκριση επιστρέφει την πραγματική τιμή του μέσου, για παράδειγμα print. Ένα PA-ID που λείπει ή είναι άγνωστο επιστρέφει 404.
404 Δεν βρέθηκε
{ "error": "Advertisement not found" }429 Υπέρβαση ορίου ποσοστού
{
"error": "Rate limit exceeded",
"limit": 10000,
"remaining": 0,
"reset": "2025-01-15T10:30:00.000Z"
}Αυτή είναι η έκδοση API v1, και κάθε απόκριση το δηλώνει σε κεφαλίδα X-API-Version. Οι ασύμβατες αλλαγές κυκλοφορούν σε νέα διαδρομή αντί να αλλάζουν αυτήν. Ένα τελικό σημείο v1 δεν θα απενεργοποιηθεί χωρίς κεφαλίδα Deprecation τουλάχιστον 90 ημέρες νωρίτερα, σύμφωνα με το RFC 8594.
Προδιαγραφή αναγνώσιμη από μηχανή
Το πλήρες έγγραφο OpenAPI 3.1 παρέχεται στο /api/docs. Στρέψτε το Postman, το Swagger UI ή μια γεννήτρια πελάτη κατευθείαν εκεί αντί να αντιγράψετε αυτή τη σελίδα.
https://polads.eu/api/docs