/v1/offers/accounts,
/v1/offers/currency, etc. — avec ses propres champs. Vous intégrez les
catégories dans lesquelles vous vendez, et une catégorie ajoutée plus tard à la
plateforme ne touche pas aux vôtres.
C’est la surface publique. Les écrans propres au tableau de bord vendeur —
retraits, litiges, paramètres du compte — n’en font pas partie, et une clé API
n’y a pas accès.
Une offre est une annonce sur la marketplace. L’API les appelle offers, et
tout ce qui suit aussi.
URL de base
/v1/....
Votre première requête
1
Créez une clé
Dans le tableau de bord vendeur, allez dans Vendeur → Clés API et créez-en
une. Elle n’est affichée qu’une fois : copiez-la à ce moment-là, il est
impossible de la relire ensuite.
2
Envoyez-la
La clé va dans l’en-tête
Authorization de chaque requête. Il n’y a rien
contre quoi l’échanger.3
Lisez les champs propres à la catégorie
Ce que prend l’appel de création d’une catégorie figure sur sa propre page de
référence : une offre de compte a un prix et des images, une offre de monnaie
a un produit et un stock. Ce qui varie selon le jeu, ce sont les
Ce chemin accepte le
attributes, et l’endpoint de schéma les décrit : les champs, leurs types et
ceux qui sont obligatoires.slug d’un jeu. Les autres chemins du catalogue
désignent un jeu par l’id que renvoie GET /v1/offers/games : un slug y
répond 400.Les lectures du catalogue sont publiques : vous pouvez les explorer avant
d’avoir une clé.Statuts
Une nouvelle offre est undraft : elle est à vous et personne d’autre ne la
voit. publish la rend active, et les acheteurs peuvent l’acheter dès cet
instant — rien ne la vérifie avant. Publier une offre qui n’a plus rien à vendre
est refusé avec 409 : ajoutez d’abord du stock. Modifier une offre ne change
pas son statut — une offre active reste en ligne, un draft reste un brouillon.
unpublish ramène une offre active en draft. archived est la fin du
parcours : DELETE retire une offre définitivement tout en la laissant lisible
pour vous. sold découle des commandes, pas des appels : la dernière unité est
partie dans une commande clôturée. Une offre dont tout le stock est dans des
commandes en cours reste active, et une commande annulée remet le stock en place.
La modération peut renvoyer une offre en ligne en changes_requested : elle
quitte la marketplace, et moderation_reason_code avec moderation_note
indiquent quoi corriger. Votre prochain PATCH en fait un draft ; publiez-la
(publish) une fois corrigée. Une offre que la modération retire pour
violation manifeste des règles est supprimée : chaque appel la concernant
répond 404.
Prix
Chaque prix de cette API est un entier en cents de dollar US.price: 4990
vaut 49,90 $. Il n’y a pas de montants fractionnaires, et USD est la seule
devise.
Pour aller plus loin
Authentification
Clés, listes d’adresses autorisées, limites de débit et signification des erreurs.
Référence de l’API
Chaque endpoint, avec un bac à sable pour envoyer de vraies requêtes.