API Wiri Connect

Une API REST orientée lecture pour extraire vos données Wiri dans des systèmes tiers, tableaux de bord et intégrations. Disponible sur les plans Enterprise.

Enterprise uniquement. L'API Wiri Connect est disponible sur le plan Enterprise. Pour générer une clé API, allez dans Paramètres → Accès API dans votre compte Wiri.

Authentification

Chaque requête doit inclure votre clé API dans l'en-tête Authorization en tant que jeton Bearer :

# Exemple avec curl
curl https://votre-domaine.com/api/v1/items \
  -H "Authorization: Bearer wk_votre_cle_api"

Si la clé est manquante ou invalide, l'API retourne 401 Unauthorized :

{
  "error": "Invalid API key."
}

URL de base

Tous les points de terminaison sont relatifs à la racine de votre installation Wiri :

https://votre-domaine.com/api/v1/

Points de terminaison

MéthodePoint de terminaisonDescription
GET /api/v1/items Lister tous les articles du menu
GET /api/v1/contacts Lister tous les clients / contacts
GET /api/v1/invoices Lister les factures — supporte ?status, ?from, ?to
GET /api/v1/sales Lister les ventes caisse — supporte ?status, ?from, ?to

Format de réponse

Toutes les réponses réussies retournent 200 OK avec un corps JSON contenant deux champs :

{
  "data": [ /* tableau d'objets */ ],
  "count": 42
}

GET /api/v1/items

Retourne tous les articles du menu de votre compte, classés alphabétiquement.

GET /api/v1/contacts

Retourne tous les contacts (clients) de votre compte, classés par nom.

GET /api/v1/invoices

Retourne les factures classées par date décroissante. Supporte les paramètres de requête suivants :

ParamètreTypeExempleDescription
statusstringPaidPaid, Unpaid ou Overdue
fromdate2026-01-01Début de la plage de dates (inclus)
todate2026-01-31Fin de la plage de dates (inclus)

GET /api/v1/sales

Retourne les ventes caisse classées par date décroissante. Supporte les mêmes paramètres que les factures, avec status acceptant paid ou voided.

Réponses d'erreur

Statut HTTPCorpsQuand
401{"error": "Invalid API key."}Clé manquante, incorrecte ou révoquée
401{"error": "Missing or malformed Authorization header."}En-tête absent ou pas au format Bearer
404{"error": "Unknown endpoint."}Nom de ressource non dans la liste autorisée

Générer une clé API

  1. Connectez-vous à votre compte Wiri (plan Enterprise requis).
  2. Allez dans Paramètres → Accès API.
  3. Cliquez sur Générer une clé API. Votre clé commence par wk_.
  4. Copiez la clé immédiatement — elle est affichée en entier une seule fois après la génération.
  5. Pour renouveler la clé, cliquez sur Régénérer la clé. L'ancienne clé cesse de fonctionner immédiatement.
Gardez votre clé secrète. Toute personne disposant de votre clé API peut lire toutes vos données commerciales. Ne la commitez pas dans le contrôle de version et ne l'exposez pas dans du code côté client.

Voir aussi : Paramètres · Aperçu Wiri Connect