Sonraí an tsiopa a athrú

Leis an API, is féidir leat sonraí do shiopa a athrú, mar shampla cur síos nó praghas táirge.

Athraigh réimsí ar leith

Ní gá sonraí uile an táirge a sheoladh chun a chur síos a athrú. San iarratas PATCH, cuir na réimsí atá á n-athrú agat agus na réimsí eile atá riachtanach don oibríocht. Fanann na sonraí eile mar atá.

Réimse fágtha ar lár: Fanann a luach gan athrú.
null: Scriosann null an luach má cheadaíonn an réimse é. Seiceáil cur síos na hoibríochta.
Teaghrán folamh: Ciallaíonn "" téacs folamh. Tá sé éagsúil le null agus ní ghlacann gach réimse leis.

Sa sampla seo, bainimid cur síos Gearmáinise an táirge. Fanann an t-ainm agus na cur síos i dteangacha eile mar atá.

PATCH/api/v1/products/example?locale=de

Iarratas cURL

curl --disable --globoff --fail-with-body --silent --show-error \
  --proto '=https' --connect-timeout 5 --max-time 30 \
  --request PATCH \
  --url 'https://shop.onshopently.com/api/v1/products/example?locale=de' \
  --header 'Authorization: Bearer EXAMPLE_ACCESS_TOKEN' \
  --header 'Idempotency-Key: example-product-clear-translation' \
  --header 'Content-Type: application/json' \
  --data-raw '{"description":null,"expected_version":1}'

Freagra

{
  "data": {
    "deleted": false,
    "id": "example",
    "version": 2
  },
  "meta": {
    "request_id": "example"
  }
}

Mura bhfaigheann tú freagra

Ní hionann gan freagra a fháil agus gan an t-athrú a bheith sábháilte. Seans gur briseadh an nasc tar éis an t-athrú a dhéanamh.

Agus sonraí á sábháil agat, cuir ceanntásc Idempotency-Key leis an iarratas agus luach uathúil ann. Mura bhfaigheann tú freagra agus má athsheolann tú an t-athrú céanna, úsáid an eochair, an seoladh, an modh agus an t-ábhar céanna.

Má tá toradh an iarratais sábháilte ag an API cheana, tugann sé ar ais é gan an t-athrú a dhéanamh arís. Úsáid eochair nua le haghaidh athrú eile.

Tugann athúsáid eochrach d'iarratas eile idempotency.key_reused.

Má athraíonn duine eile na sonraí céanna

Faigh na sonraí reatha sula ndéanann tú athrú. Má éilíonn an oibríocht expected_version, cuir an leagan a fuair tú sa réimse sin.

Má d’athraigh duine na sonraí idir an dá linn, diúltaíonn an API don tsábháil. Faigh arís iad agus seiceáil an bhfuil an t-athrú atá beartaithe fós oiriúnach. Ansin amháin seol iarratas nua leis an leagan reatha.

D’fhéadfadh leagan an phraghais, an athraithe nó an liosta praghsanna a bheith ag teastáil chun praghas a athrú freisin. Tá na réimsí riachtanacha i gcur síos na hoibríochta.