Lister les magasins

Liste les points de vente. Utilisez city comme libellé lisible avec name. Sans pagination : renvoie jusqu’à limit magasins actifs, triés par id, sans nextCursor.

GET/stores

Autorisation

AuthorizationJeton Bearer (clé API) · headerobligatoire

Clé API de l’organisation.

Paramètres de requête

limitinteger

Taille de page (1–5000, défaut 100).

min 1 · max 5000 · default: 100

Réponses

200

Magasins avec meta

dataStore[]obligatoire

Afficher les propriétés

Tableau de Store

idstringobligatoire

namestring

citystring

Libellé lisible du magasin au sein de l’organisation

addressstring

zipCodestring

vatNumberstring

paymentCashboolean

paymentPaytecboolean

paymentZahlsboolean

paymentZahlsOfflineboolean

paymentCashOfflineboolean

showSupplierboolean

logoUrlstring

languageMainstring

Autorisé:deenfrit

deletedboolean

metaListMetaobligatoire

Métadonnées de liste. returned est la longueur de data. Les entrées de catalogue supprimées (soft delete) sont exclues des listes — returned peut être inférieur à limit même s'il reste des entrées actives.

Afficher les propriétés

totalintegerobligatoire

Avec recherche produit (q) : nombre estimé de correspondances. Sinon égal à returned. Peut être inférieur à limit lorsque des entrées supprimées ont été filtrées de la page.

returnedintegerobligatoire

Nombre d’éléments dans data. Avec includeDeleted=true (commandes), les commandes supprimées sont comptées.

limitintegerobligatoire

Taille de page appliquée.

offsetinteger

Uniquement pour la recherche produit avec q.

nextCursorstring

Curseur opaque pour la page suivante ; à transmettre tel quel dans cursor. Présent lorsque d’autres résultats peuvent exister. Les éléments supprimés logiquement sont filtrés après lecture, une page peut donc être plus courte que limit alors que nextCursor est présent. Jamais renvoyé pour les catégories, fournisseurs et magasins, qui ne sont pas paginés.

400

Paramètres de requête invalides.

errorValidationErrorobligatoire

Détails de validation.

Afficher les propriétés

formErrorsstring[]obligatoire

fieldErrorsobjectobligatoire

403

Clé API absente, inconnue ou inactive, ou clé Read sur une opération d’écriture.

statusCodeintegerobligatoire

Code de statut HTTP

messagestringobligatoire

Message d’erreur lisible

timestampstring<date-time>obligatoire

Moment de l’erreur (UTC).

pathstringobligatoire

URL de la requête (chemin et chaîne de requête).

Essayer

Serveur

URL de baseURL de base personnaliséeRemplace le serveur sélectionné si renseignée.

Autorisation

Jeton Bearer (clé API)Mémoriser sur cet appareilUtiliser mes valeurs dans les exemples

Paramètres

limitqueryTaille de page (1–5000, défaut 100).

Requête

curl -X GET 'https://dashboard.scango.ch/api/v1/stores' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://dashboard.scango.ch/api/v1/stores", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://dashboard.scango.ch/api/v1/stores",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://dashboard.scango.ch/api/v1/stores',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
  ],
]);

$response = curl_exec($curl);

Réponse

{
  "data": [
    {
      "id": "store_01",
      "name": "Magasin principal",
      "city": "Zürich",
      "address": "Bahnhofstrasse 1",
      "zipCode": "8001"
    }
  ],
  "meta": {
    "total": 1,
    "returned": 1,
    "limit": 100
  }
}

{
  "error": {
    "formErrors": [],
    "fieldErrors": {
      "limit": [
        "Number must be less than or equal to 5000"
      ]
    }
  }
}

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