Aggiorna negozio

Aggiorna un negozio (il body POST è parziale). Richiede una chiave Write. Invia null per cancellare un campo opzionale. Le credenziali Zahls restano solo nel dashboard.

POST/stores/{storeId}

Autorizzazione

AuthorizationToken Bearer (chiave API) · headerobbligatorio

Chiave API dell'organizzazione.

Parametri path

storeIdstringobbligatorio

Corpo della richiesta

obbligatorioapplication/json

namestring

min length 1

addressstring | null

zipCodestring | null

citystring | null

Etichetta leggibile del negozio nell'organizzazione

vatNumberstring | null

paymentCashboolean | null

paymentPaytecboolean | null

paymentZahlsboolean | null

paymentZahlsOfflineboolean | null

paymentCashOfflineboolean | null

showSupplierboolean | null

hideTextStartboolean | null

generalMarginnumber | null

customMessagestring | null

backgroundImageCartstring | object | null

null rimuove il campo.

Mostra proprietà

Uno tra:

string

string

object

srcstring

backgroundImagestring | object | null

null rimuove il campo.

Mostra proprietà

Uno tra:

string

string

object

srcstring

backgroundColorstring | null

backgroundFontColorstring | null

playSoundboolean | null

standardSoundstring | null

adminMailstring | null

showInfoButtonboolean | null

showPicturesboolean | null

showPicturesScaleboolean | null

deleteCountdownnumber | null

logoUrlstring | null

languageMultiboolean | null

languageMainstring | null

Consentiti:deenfrit

languageSelectorstring[] | null

translationsobject | null

deletedboolean

Imposta true per il soft-delete.

Risposte

200

Aggiornato

successbooleanobbligatorio

400

Parametri o body non validi.

statusCodeintegerobbligatorio

Codice di stato HTTP

messagestringobbligatorio

Messaggio di errore leggibile

timestampstring<date-time>obbligatorio

Momento dell’errore (UTC).

pathstringobbligatorio

URL della richiesta (percorso e query string).

403

Chiave API mancante, sconosciuta o inattiva, oppure chiave Read su un’operazione di scrittura.

statusCodeintegerobbligatorio

Codice di stato HTTP

messagestringobbligatorio

Messaggio di errore leggibile

timestampstring<date-time>obbligatorio

Momento dell’errore (UTC).

pathstringobbligatorio

URL della richiesta (percorso e query string).

404

Nessun elemento con questo id.

statusCodeintegerobbligatorio

Codice di stato HTTP

messagestringobbligatorio

Messaggio di errore leggibile

timestampstring<date-time>obbligatorio

Momento dell’errore (UTC).

pathstringobbligatorio

URL della richiesta (percorso e query string).

Prova

Server

URL di baseURL di base personalizzatoSostituisce il server selezionato se impostato.

Autorizzazione

Token Bearer (chiave API)Ricorda su questo dispositivoUsa i miei valori negli esempi

Parametri

storeIdpath*

Bodyapplication/json

Corpo della richiesta

Richiesta

curl -X POST 'https://dashboard.scango.ch/api/v1/stores/string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "city": "Bern"
}'

const response = await fetch("https://dashboard.scango.ch/api/v1/stores/string", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"city\": \"Bern\"\n}"
});

import requests

response = requests.post(
    "https://dashboard.scango.ch/api/v1/stores/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"city\": \"Bern\"\n}",
)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://dashboard.scango.ch/api/v1/stores/string',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => '{
  "city": "Bern"
}',
]);

$response = curl_exec($curl);

Risposta

{
  "success": true
}

{
  "statusCode": 400,
  "message": "Validation failed for Field: name, Error: Required",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/suppliers"
}

{
  "statusCode": 403,
  "message": "Unknown Error",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/products"
}

{
  "statusCode": 0,
  "message": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "path": "string"
}