Skapa eller uppdatera produkt
PUT/api/v1/stores/{store_id}/products/{product_id}
Skapar produkten med butikens id, eller uppdaterar den. Skickas variants ersätter de alla varianter.
Fält du utelämnar behålls; null tömmer dem. Svarar 201 när produkten skapades och 200 när den uppdaterades.
Behörighet
ecommerce:writeÄndra e-handel – personen bakom nyckeln måste vara redaktör eller högre.
Sökvägsparametrar
store_idstringkrävs- Butikens id, som ni väljer.
product_idstringkrävs- Produktens id i er butik.
Kropp
JSON, Content-Type: application/json. Okända fält ger 422.
titlestringkrävs- Produktens namn.minst 1 tecken · högst 255 tecken
urlstring | null- Produktens sida i butiken.högst 2048 tecken
image_urlstring | null- Produktens bild.högst 2048 tecken
vendorstring | null- Tillverkare eller varumärke.högst 255 tecken
product_typestring | null- Produkttyp eller kategori.högst 255 tecken
variantsarray<object>- Varianterna (högst 100). Ersätter alla varianter när de skickas.högst 100 st
variants[].idstringkrävs- Variantens id i er butik.
variants[].titlestringkrävs- minst 1 tecken · högst 255 tecken
variants[].skustring | null- Artikelnummer.högst 100 tecken
variants[].pricenumber | null- Pris per styck.minst 0 · högst 999999999999.99
variants[].inventory_quantityinteger | null- Antal i lager.minst -1000000 · högst 1000000000
variants[].urlstring | null- Variantens sida.högst 2048 tecken
variants[].image_urlstring | null- Variantens bild.högst 2048 tecken
Göra om anropet
PUT skapar eller uppdaterar på butikens egna id: samma anrop två gånger ger samma resultat, så det kan alltid göras om. Batch och idempotens
Svar
200 Produkten (201 om den skapades).
idstringkrävstitlestringkrävsurlstring | nullkrävsimage_urlstring | nullkrävsvendorstring | nullkrävsproduct_typestring | nullkrävsvariantsarray<object>krävsvariants[].idstringkrävsvariants[].titlestringkrävsvariants[].skustring | nullkrävsvariants[].pricenumber | nullkrävsvariants[].inventory_quantityinteger | nullkrävsvariants[].urlstring | nullkrävsvariants[].image_urlstring | nullkrävscreated_atstring (tid, ISO 8601)krävs- När produkten skickades in första gången.
updated_atstring (tid, ISO 8601)krävs- När produkten senast ändrades.
Fel
- 400
- bad_request
- 404
- not_found
- 429
- rate_limited