Passer au contenu principal
Chariow est une plateforme de commerce numérique qui vous permet de vendre des produits numériques, gérer des clients, traiter des paiements et gérer des clés de licence via une API simple.

​
Fonctionnalités clés

Produits

Créez et gérez des produits numériques avec des prix flexibles

Paiement

Traitez les paiements de manière sécurisée via l’API

Clients

Gérez les profils et l’historique des clients

Licences

Émettez et gérez des clés de licence logicielle

​
Démarrage rapide

1

Créer une clé API

Connectez-vous à app.chariow.com, allez dans Paramètres > Clés API et créez une nouvelle clé.
2

Faire votre première requête

Utilisez votre clé API pour récupérer les informations de votre boutique :
curl -X GET "https://api.chariow.com/v1/store" \
  -H "Authorization: Bearer VOTRE_CLE_API"
3

Explorer l'API

Parcourez la référence API pour découvrir tous les endpoints disponibles.

​
URL de base

Toutes les requêtes API doivent être effectuées vers : 
https://api.chariow.com/v1

​
Format des réponses

Toutes les réponses API suivent une structure JSON cohérente : 
{
  "message": "success",
  "data": {
    // Données de la réponse
  },
  "errors": []
}

​
Réponse réussie

{
  "message": "success",
  "data": {
    "id": "prd_abc123",
    "name": "Cours Premium",
    "price": {
      "amount": 4900,
      "currency": "EUR"
    }
  },
  "errors": []
}

​
Réponse d’erreur

{
  "message": "La validation a échoué",
  "data": [],
  "errors": {
    "email": ["Le champ email est requis."],
    "product_id": ["Le produit sélectionné est invalide."]
  }
}

​
Pagination

Les endpoints de liste utilisent une pagination par curseur : 
{
  "message": "success",
  "data": {
    "data": [...],
    "pagination": {
      "next_cursor": "eyJpZCI6NTB9",
      "prev_cursor": null,
      "has_more": true
    }
  },
  "errors": []
}
Utilisez le paramètre cursor pour naviguer entre les pages : 
GET /v1/products?cursor=eyJpZCI6NTB9&per_page=20

​
Limites de débit

L’API implémente des limites de débit pour garantir une utilisation équitable :
Type d’endpointLimite
Toutes les requêtes API10 requêtes/minute
Les limites de débit sont appliquées par clé API. Chaque réponse inclut des en-têtes de limite de débit : 
X-RateLimit-Limit: 10
X-RateLimit-Remaining: 8
X-RateLimit-Reset: 1642089600
Lorsque vous dépassez la limite de débit, vous recevrez une réponse 429 Too Many Requests : 
{
  "message": "Trop de requêtes. Veuillez réessayer plus tard.",
  "data": [],
  "errors": []
}
Besoin de limites plus élevées ? Contactez-nous à [email protected] pour discuter des options entreprise.

​
Authentification

L’API utilise l’authentification Bearer token. Incluez votre clé API dans l’en-tête Authorization : 
Authorization: Bearer VOTRE_CLE_API

En savoir plus sur l'authentification

Apprenez à sécuriser vos requêtes API

​
Besoin d’aide ?

Référence API

Documentation complète de l’API

Support

Contactez notre équipe

Communauté

Rejoignez la communauté