Authentification

L’API Chariow utilise des clés API pour authentifier les requêtes.

Créer une clé API

Connexion au tableau de bord

Allez sur app.chariow.com et connectez-vous à votre compte.

Accéder aux paramètres

Cliquez sur Paramètres dans la barre latérale.

Ouvrir les clés API

Sélectionnez Clés API dans le menu des paramètres.

Créer une nouvelle clé

Cliquez sur Créer une clé API, donnez-lui un nom descriptif et copiez la clé générée.

Copiez votre clé API immédiatement après sa création. Pour des raisons de sécurité, la clé complète n’est affichée qu’une seule fois.

Effectuer des requêtes authentifiées

Incluez votre clé API dans l’en-tête Authorization de chaque requête :

Authorization: Bearer VOTRE_CLE_API

Exemple de requête

curl -X GET "https://api.chariow.com/v1/store" \
  -H "Authorization: Bearer VOTRE_CLE_API"

const response = await fetch('https://api.chariow.com/v1/store', {
  headers: {
    'Authorization': 'Bearer VOTRE_CLE_API'
  }
});

import requests

headers = {
    'Authorization': 'Bearer VOTRE_CLE_API'
}

response = requests.get('https://api.chariow.com/v1/store', headers=headers)

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.chariow.com/v1/store');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer VOTRE_CLE_API'
]);

Bonnes pratiques de sécurité

Utiliser des variables d'environnement

Stockez les clés API dans des variables d’environnement, pas dans votre code :

# Fichier .env
CHARIOW_API_KEY=votre_cle_api

# Accès dans votre code
process.env.CHARIOW_API_KEY

Utiliser des clés différentes par environnement

Créez des clés API distinctes pour le développement, le staging et la production. Cela limite l’impact en cas de compromission d’une clé.

Renouveler les clés régulièrement

Créez périodiquement de nouvelles clés et désactivez les anciennes. Cela réduit la fenêtre d’opportunité pour les clés compromises.

Surveiller l'utilisation des clés

Vérifiez régulièrement l’utilisation de vos clés API dans le tableau de bord. Recherchez les schémas inhabituels qui pourraient indiquer un accès non autorisé.

Restreindre au côté serveur

N’exposez jamais votre clé API dans le code côté client (JavaScript s’exécutant dans les navigateurs). Tous les appels API doivent être effectués depuis votre serveur.

Erreurs d’authentification

Si l’authentification échoue, vous recevrez une réponse 401 Non autorisé :

{
  "message": "La clé API est manquante. Veuillez fournir une clé API valide.",
  "data": [],
  "errors": []
}

Causes courantes des échecs d’authentification :

Erreur	Cause	Solution
En-tête manquant	Pas d’en-tête `Authorization`	Ajoutez l’en-tête à votre requête
Clé invalide	La clé n’existe pas ou a été supprimée	Générez une nouvelle clé dans votre tableau de bord
Mauvaise boutique	La clé appartient à une autre boutique	Utilisez la bonne clé pour votre boutique

Limitation de débit

Les clés API sont soumises à une limitation de débit pour garantir une utilisation équitable :

100 requêtes par minute par clé API

En cas de dépassement, vous recevrez une réponse 429 Trop de requêtes.

Besoin de limites plus élevées ? Contactez notre équipe support à support@chariow.com.

Introduction

Guides

Intégration MCP

Intégration n8n

Resources

Créer une clé API

Effectuer des requêtes authentifiées

Exemple de requête

Bonnes pratiques de sécurité

Erreurs d’authentification

Limitation de débit

Prochaines étapes

Référence API

Limites de débit

​Créer une clé API

​Effectuer des requêtes authentifiées

​Exemple de requête

​Bonnes pratiques de sécurité

​Erreurs d’authentification

​Limitation de débit

​Prochaines étapes

Référence API

Limites de débit

Créer une clé API

Effectuer des requêtes authentifiées

Exemple de requête

Bonnes pratiques de sécurité

Erreurs d’authentification

Limitation de débit

Prochaines étapes