Seller API
Това ръководство е написано на английски.
For approved sellers with a seller key. List your offers, keep prices and stock current, and deliver the orders that wait for your keys.
| Call | Permission | What for |
|---|---|---|
GET /api/v1/seller/offers | seller:read | Your offers with status and stock. |
POST /api/v1/seller/offers | offers:write | Create an offer (price you want to receive per unit). |
POST /api/v1/seller/offers/{id}/price | offers:write | Change the price of one offer. |
POST /api/v1/seller/prices:batch | offers:write | Change up to 100 prices in one call. |
POST /api/v1/seller/offers/{id}/stock | stock:write | Upload keys (stock) to an offer, up to 500 a call. |
POST /api/v1/seller/offers/{id}/stock:upload | stock:write | Large uploads as a background job. |
GET /api/v1/seller/reservations | seller:read | Paid orders that wait for your keys, oldest deadline first. |
GET, POST /api/v1/seller/webhooks | webhooks:manage | Seller webhooks (order.paid, order.stock_needed, ...). |
- Prices are what you want to receive per unit; the commission is added on top for the buyer.
- Large price changes may be held for review. Uploaded keys are checked against every key on the platform; a duplicate is refused.
GET /api/v1/seller/reservationslists paid orders inpaid_heldorstock_not_uploadedwithdeliver_by. Deliver before it.- Migrating from another marketplace: /docs/migrate.