Πισtoποίηση
Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Το κλειδί πρέπει να διαθέτει το δικαίωμα sites.view· ένα κλειδί που δεν το διαθέτει απορρίπτεται με 403, όχι 404.
Πού μπαίνει το αναγνωριστικό του οργανισμού σας
Αυτό το τελικό σημείο δέχεται την παράμετρο org_id ως παράμετρο ερωτήματος. Παραλείψτε την και η κλήση καλύπτει ολόκληρο το υποδέντρο μίσθωσής σας· στείλτε την για να περιορίσετε την κλήση σε έναν οργανισμό.
Το αναγνωριστικό του οργανισμού σας βρίσκεται στην οθόνη των κλειδιών API στον πίνακα ελέγχου σας, δίπλα στο ίδιο το κλειδί. Είναι το ίδιο αναγνωριστικό σε κάθε κλήση που πραγματοποιείτε.
Δοκιμάστε το
Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.
curl -X GET https://api.zinndigital.com/v1/offers \
-H "Authorization: Bearer zdk_live_…"Συνδεθήκατε; Η κονσόλα API στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό API, ώστε να μπορείτε να δείτε την πραγματική απόκριση. Ανοίξτε αυτό το τελικό σημείο στην κονσόλα API
Λεπτομέρειες
⚖️ Owner, 2026-08-28: *"on the app overview screen should we not upsell some things"*, and — on how they are chosen — *"we shuld have 3 there and they should roate ... we should be able to devide in admin which ones to incluide and which not with siple on off swithc"*. Every **active** offer whose audience reaches this customer and whose signal is true for them, ordered by the rank an operator set, with copy already translated into the reader's own language. ⛔ **Every earned offer is returned, not the first `slots` of them.** The rotation that shows a different few on each visit is the client's, and it can only rotate over what it is given — truncating here would leave the dashboard cycling the same three cards for ever while appearing to work. The list is bounded by the size of a catalogue staff maintain by hand: tens, never thousands. ⛔ A reseller's own client is served an **empty list**, whatever the catalogue says. Selling Zinn® products at Zinn® prices inside a reseller's white-labelled dashboard, to the reseller's customer, undercuts the reseller who is paying us (owner ruling, same day). An account that is not in good standing is likewise never sold to (§2.46). ⛔ An offer whose link names a site the reader does not have is **dropped**, not rendered with a broken destination. Requires `sites.view`.
Παράμετροι
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
org_id (query) | Uuid | Όχι | Which organization this is about. Required when the caller holds more than one; a caller in exactly one may omit it. An id outside the caller's scope, or an omission by a multi-… |
Απάντηση
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
data | Offer[] | Ναι | — |
slots | integer | Ναι | How many to show at once. ⚖️ The owner's number (3, 2026-08-28), served in the payload rather than hardcoded in the SPA so changing it is a deploy of one service instead of a co… |
Σφάλματα που μπορεί να επιστρέψει αυτό το τελικό σημείο
401 · 403 · 429