/v1/offers/accounts, /v1/offers/currency
og så videre — med sine egne felter. Du integrerer med de kategorier, du
sælger i, og en kategori, der senere tilføjes platformen, rører ikke dine.
Dette er den offentlige overflade. Sælgerpanelets egne skærme — udbetalinger,
tvister, kontoindstillinger — er ikke en del af den, og en API-nøgle kan ikke
nå dem.
Et tilbud er én annonce på markedspladsen. API’et kalder dem offers, og
det gør alt nedenfor også.
Base-URL
/v1/....
Din første forespørgsel
1
Opret en nøgle
Gå i sælgerpanelet til Sælger → API-nøgler, og opret en. Den vises
én gang — kopiér den med det samme, den kan ikke læses igen.
2
Send den
Nøglen skal i
Authorization-headeren i hver forespørgsel. Den skal ikke
byttes til noget.3
Læs kategoriens egne felter
Hvad en kategoris oprettelseskald tager imod, står på dens egen
referenceside — et kontotilbud har en pris og billeder, et valutatilbud har
et produkt og et lager. Det, der varierer fra spil til spil, er
Denne sti slår et spil op via dets
attributes, og schema-endpointet svarer med dem: felterne, deres typer,
og hvilke der er påkrævede.slug. De øvrige katalogstier angiver
et spil med det id, som GET /v1/offers/games returnerer — en slug dér
giver 400.Læsning af kataloget er offentlig — du kan udforske det, før du har en nøgle.Statusser
Et nyt tilbud er endraft: dit, og ingen andre kan se det. publish gør det
active, og købere kan købe det fra det øjeblik — intet gennemgår det først.
Udgivelse af et tilbud uden noget tilbage at sælge afvises med 409: fyld
lageret op først. Redigering ændrer intet ved et tilbuds status — et active
forbliver live, en draft forbliver en kladde.
unpublish sender et active tilbud tilbage til draft. archived er
endestationen: DELETE trækker et tilbud tilbage for altid og lader det være
læsbart for dig. sold følger ordrer, ikke kald: den sidste enhed gik til en
lukket ordre. Et tilbud, hvis lager ligger i åbne ordrer, forbliver active,
og en annulleret ordre lægger lageret tilbage.
Moderatorerne kan sende et live tilbud tilbage som changes_requested: det
forlader markedspladsen, og moderation_reason_code sammen med
moderation_note fortæller, hvad der skal rettes. Dit næste PATCH gør det
til en draft; publish det, når det er rettet. Et tilbud, som moderatorerne
fjerner for et direkte regelbrud, slettes: alle kald til det svarer 404.
Priser
Alle priser i dette API er heltal i amerikanske cent.price: 4990 er $49,90.
Der findes ingen brøkbeløb, og USD er den eneste valuta.
Hvor du går hen herfra
Godkendelse
Nøgler, adresselister, hastighedsgrænser og hvad fejlene betyder.
API-reference
Alle endpoints med en playground, du kan sende rigtige forespørgsler fra.