Τεκμηρίωση API SSP

Μία διεύθυνση URL ανά έκδοση

Τα χειριστήρια της επίδειξης αντιστοιχούν ένα προς ένα σε αυτές τις παραμέτρους, οπότε μπορείτε να επιλέξετε στη σελίδα επίδειξης και να αντιγράψετε τη διεύθυνση 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."
}

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

400 Εσφαλμένο αίτημα

Η διαφήμιση βρέθηκε, αλλά το μέσο της δεν είναι online. Η απόκριση επιστρέφει την πραγματική τιμή του μέσου, για παράδειγμα print. Ένα PA-ID που λείπει ή είναι άγνωστο επιστρέφει 404.

{
  "error": "This endpoint is only for online advertisements",
  "medium": "print"
}

404 Δεν βρέθηκε

{
  "error": "Advertisement not found"
}

429 Υπέρβαση ορίου αιτημάτων

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