Verkäufer-API
Für freigeschaltete Verkäufer mit einem Verkäufer-Schlüssel. Angebote auflisten, Preise und Bestand aktuell halten und die Bestellungen liefern, die auf deine Keys warten.
| Aufruf | Recht | Wozu |
|---|---|---|
GET /api/v1/seller/offers | seller:read | Deine Angebote mit Status und Bestand. |
POST /api/v1/seller/offers | offers:write | Angebot anlegen (Preis, den du je Stück bekommen willst). |
POST /api/v1/seller/offers/{id}/price | offers:write | Preis eines Angebots ändern. |
POST /api/v1/seller/prices:batch | offers:write | Bis zu 100 Preise in einem Aufruf ändern. |
POST /api/v1/seller/offers/{id}/stock | stock:write | Keys (Bestand) zu einem Angebot hochladen, bis 500 je Aufruf. |
POST /api/v1/seller/offers/{id}/stock:upload | stock:write | Große Uploads als Hintergrundauftrag. |
GET /api/v1/seller/reservations | seller:read | Bezahlte Bestellungen, die auf deine Keys warten, älteste Frist zuerst. |
GET, POST /api/v1/seller/webhooks | webhooks:manage | Verkäufer-Webhooks (order.paid, order.stock_needed, ...). |
- Preise sind das, was du je Stück bekommen willst; die Provision kommt für den Käufer obendrauf.
- Große Preisänderungen können zur Prüfung angehalten werden. Hochgeladene Keys werden gegen jeden Key der Plattform geprüft; ein Duplikat wird abgelehnt.
GET /api/v1/seller/reservationslistet bezahlte Bestellungen inpaid_heldoderstock_not_uploadedmitdeliver_by. Liefere vorher.- Umzug von einem anderen Marktplatz: /docs/migrate.