offers

GET /v1/offers

The upsells this customer has earned, best first.

Све offers крајње тачке

Сва документација за програмере →

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.view; кључ без ње се одбија уз 403, а не 404.

Где се уноси ID ваше организације

Ова крајња тачка прихвата org_id као параметар упита. Изоставите га и позив ће обухватити цело подстабло вашег закупа; пошаљите га да бисте сузили позив на једну организацију.

Идентификатор ваше организације се налази на екрану са API кључевима на вашој контролној табли, поред самог кључа. То је исти идентификатор у сваком позиву који упутите.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X GET https://api.zinndigital.com/v1/offers \
  -H "Authorization: Bearer zdk_live_…"

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом 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.

Параметри

НазивТипОбавезноШта је ово
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…

Одговор

НазивТипОбавезноШта је ово
dataOffer[]Да—
slotsintegerДа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…

Грешке које ова крајња тачка може вратити

401 · 403 · 429