Démarrage rapide

Ce guide récupère les deux dernières commandes de vente de votre espace. Avant de commencer, lisez l’introduction à l’API GraphQL.

Créez un jeton d'API

Créez le jeton depuis les paramètres de votre espace Bonx, dans la section Tokens d’API. Consultez Authentification si nécessaire.Le même jeton fonctionne avec les API REST et GraphQL.

Enregistrez l'URL et le jeton

L’URL GraphQL de votre espace est fournie avec le jeton.

export BONX_GRAPHQL_URL="https://VOTRE-URL-GRAPHQL"
export BONX_API_KEY="bxk_live_..."

$env:BONX_GRAPHQL_URL = "https://VOTRE-URL-GRAPHQL"
$env:BONX_API_KEY = "bxk_live_..."

Envoyez la requête

Choisissez l’exemple adapté à votre environnement.

curl -X POST "$BONX_GRAPHQL_URL" \
  -H "x-api-key: $BONX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"{ salesOrders(limit: 2, orderBy: {createdAt: DESC}) { id name stockAvailability } }"}'

const response = await fetch(process.env.BONX_GRAPHQL_URL, {
  method: 'POST',
  headers: {
    'x-api-key': process.env.BONX_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    query: `query GetSalesOrders($limit: Int!) {
      salesOrders(limit: $limit, orderBy: { createdAt: DESC }) {
        id
        name
        stockAvailability
      }
    }`,
    variables: { limit: 2 },
  }),
})

const { data, errors } = await response.json()

La réponse contient les champs id, name et stockAvailability pour chaque commande trouvée.

Une requête GraphQL peut renvoyer un statut HTTP 200 avec un tableau errors. Vérifiez toujours errors avant d’utiliser data.

Guides

Démarrage rapide

Étape suivante

Lire des données

Rattacher un document

​Étape suivante

Lire des données

Rattacher un document

Étape suivante