get
https://{customer_host}/skuu/v1/products
Return one page of the online store's complete catalogue. SKUU reads the whole catalogue this way every 12 hours by default. Each read is a complete snapshot. Only a snapshot that validates from the first page to the last counts.
- Pagination:
limitis required and SKUU sends 100. Support 1 to 250 and never return more than requested.cursoris absent on the first request. Returnnext_cursorwhile more pages exist andnullon the last page. A cursor is opaque; SKUU sends it back as a string. Keep the snapshot stable while SKUU pages through it. - Completeness: returning
nullearly ends the snapshot early. Every variant missing from a completed snapshot is retired and its network stock set to zero. To remove a product, stop returning it. - Required fields: every product has
product_id,title,brand, at least one public HTTPS image and at least one variant. Every variant hasvariant_id,size(exactlyOne sizefor an article without a size),price,currencyandinventory. Sendbarcodewhenever the store has it. - How SKUU links products: by barcode first, then the store's SKU, then title and size within the same brand. A catalogue with barcodes links almost completely. Colour is stored and shown, never compared.
- What makes SKUU reject a snapshot: a missing brand, image or size, a currency that differs from the store's, a duplicate
product_idorvariant_id, a product without variants, a variant missing an agreed location or listing an unknown one, a location id that is not a plain whole number, or a number sent as a string. A rejected snapshot changes nothing; the previous one stays in force. - Retries: SKUU retries a network failure,
429and any5xx; the schedule is on Errors and retries. Any other4xxstops the flow and alerts SKUU customer service.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
