Démarrage rapide

En 10 minutes environ : envoyez votre première requête (query) et trouvez les ID de votre boutique et de votre appareil.

Avant de commencer

• Une clé d'API Staging ou Production (voir Environnements).
• Le Device ID sous lequel votre intégration est enregistrée. Il est nécessaire pour créer certaines entités (voir Votre boutique et votre appareil).
• Le Playground Apollo GraphQL (voir Playground).

Obtenir les informations de votre boutique

Requête :

query Shops {
  shops {
    edges {
      node {
        id
        name
      }
    }
  }
}

Réponse :

{
  "data": {
    "shops": {
      "edges": [
        {
          "node": {
            "id": "8d6f…", // This is your ShopID
            "name": "My wine shop"
          }
        }
      ]
    }
  }
}

Votre boutique et votre appareil

Vos requêtes ont besoin de deux ID : une boutique et un appareil.

• La boutique (shopId) : presque tout dans Wino appartient à une boutique : produits, prix, stock, clients. Un commerçant qui a une boutique à Lyon et une à Paris a deux catalogues ; quand vous créez un produit, Wino doit donc savoir dans quelle boutique il va.
• L'appareil (deviceId) : un appareil est la source d'une modification : la caisse d'une boutique, le back-office web, un ERP ou votre intégration. Wino l'enregistre sur chaque mouvement de stock (createStockActivity en a besoin), pour que le commerçant puisse voir qu'une vente vient du site web et non de la caisse.

L'ID de votre appareil vous est fourni avec votre clé d'API. devices liste les appareils de vos boutiques, avec leur boutique. slug indique ce qu'est chaque appareil : W est le back-office web, d le tableau de bord, ERP une intégration ERP, BOT les modifications automatiques de Wino, et toute autre valeur est une caisse.

query Devices {
  devices(first: 50) {
    edges {
      node {
        id
        name
        slug
        shop {
          id
          name
        }
      }
    }
  }
}

Vous pouvez lire les autres appareils, mais ne les utilisez pas : enregistrez vos modifications uniquement avec votre propre appareil. L'API ne crée ni ne modifie d'appareils.

Et ensuite

• Playground : essayez des requêtes dans votre navigateur.
• Catalogue : comment les produits, les variantes, les prix et le stock s'articulent.
• Webhooks : soyez notifié quand les données changent.