Démarrage rapide

Ce guide vous mène de zéro à votre premier appel d’API : vous créez un token, listez vos clients, puis lisez l’un d’entre eux.

Prérequis

Un compte Qwoty sur qwoty.app avec un rôle disposant du droit Développeurs (nécessaire pour gérer les tokens d’API).
Un terminal avec curl, ou n’importe quel client HTTP.

Créer un token d’API

Dans Qwoty, allez dans Paramètres › Développeur › Tokens d’API et cliquez sur Créer un Token API. Saisissez un Nom du Token, choisissez le Rôle dont le token utilisera les droits, puis cliquez sur Créer le Token.Cliquez sur Copier le Token : le token ne s’affiche qu’une seule fois. Il se présente sous la forme qwt_prod_ suivi de 64 caractères hexadécimaux.Consultez Authentification pour en savoir plus sur la portée des tokens et les rôles.

Stocker le token dans une variable d’environnement

export QWOTY_API_TOKEN="qwt_prod_xxxxxxxxxxxxxxxx"

Gardez le token hors de votre code source et ne l’utilisez jamais dans un navigateur ou une application mobile.

Lister vos clients

Tous les endpoints se trouvent sous https://qwoty.app/api. Envoyez votre première requête :

curl https://qwoty.app/api/customers \
  -H "Authorization: Bearer $QWOTY_API_TOKEN"

Vous obtenez les clients du workspace du token, triés par nom :

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Acme Corporation",
      "type": "company",
      "id_crm": "crm_001",
      "contact_ids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
      "address_ids": ["c3d4e5f6-a7b8-9012-cdef-123456789012"],
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ]
}

L’exemple est abrégé : consultez Lister les clients pour le détail de chaque champ.

Lire un client

Copiez un id de la réponse précédente et récupérez le client complet, champs personnalisés compris :

curl https://qwoty.app/api/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer $QWOTY_API_TOKEN"

En cas de problème

Réponse	Point à vérifier
`401` `Missing authorization token`	L’en-tête doit être exactement `Authorization: Bearer <token>`.
`401` `Invalid or expired token`	Le token est mal saisi ou a été supprimé, ou son rôle a été supprimé. Créez-en un nouveau.
`404`	L’ID n’existe pas dans le workspace du token.
`429`	Trop de requêtes simultanées. Patientez puis réessayez : consultez Limites de débit et nouvelles tentatives.

Étapes suivantes

Permissions

Comprenez quels droits de rôle chaque endpoint vérifie.

Gestion des erreurs

Codes de statut et corps d’erreur.

Webhooks

Soyez notifié quand des devis, des produits ou des clients changent.

API Devis

Listez les devis et lisez leur contenu complet.

Démarrage

Concepts essentiels

Ressources

Conformité

Politiques

Démarrage rapide

Prérequis

En cas de problème

Étapes suivantes

Permissions

Gestion des erreurs

Webhooks

API Devis

​Prérequis

​En cas de problème

​Étapes suivantes

Permissions

Gestion des erreurs

Webhooks

API Devis

Prérequis

En cas de problème

Étapes suivantes