Documentation de l'API

Apprenez a integrer l'API Mercozy pour gerer les produits, commandes, stocks et plus encore.

Pour Commencer

Obtenez votre cle API

Connectez-vous en tant qu'Admin et allez à Paramètres > Intégration > Clés API pour générer une nouvelle clé. Seuls les utilisateurs Admin ont la permission.

Incluez-la dans les requetes

Ajoutez l'en-tete X-API-Key a toutes vos requetes API.

Commencez a envoyer des requetes

Utilisez n'importe quel client HTTP pour interagir avec les endpoints de l'API Mercozy.

Authentification

Toutes les requetes API necessitent une cle API valide envoyee via l'en-tete X-API-Key.

bash

curl https://api.mercozy.com/api/v1/external/products \
  -H "X-API-Key: mk_live_your_key_here"

Les cles API sont liees a votre tenant. Gardez-les secretes et ne les exposez jamais dans le code cote client.

URL de Base

https://api.mercozy.com/api/v1/external

Limites de Debit

Les limites de debit de l'API dependent de votre plan d'abonnement.

Plan	Limite de Debit	Acces API
Free / Standard	Pas d'acces API	No
Pro	300 req/min	Yes
Business	1,000 req/min	Yes

Format de Reponse

Toutes les reponses sont retournees au format JSON.

Reponse Reussie

json

{
  "data": [
    {
      "id": "prod_abc123",
      "name": "Premium Widget",
      "price": 2999,
      "currency": "USD"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 20
  }
}

Reponse d'Erreur

json

{
  "statusCode": 401,
  "message": "Invalid API key",
  "error": "Unauthorized"
}

Codes d'Erreur

Code	Statut	Description
VALIDATION_ERROR	400	Parametres de requete invalides
UNAUTHORIZED	401	Cle API invalide ou manquante
FORBIDDEN	403	Permissions insuffisantes
NOT_FOUND	404	Ressource non trouvee
CONFLICT	409	La ressource existe deja ou conflit
RATE_LIMITED	429	Trop de requetes
INTERNAL_ERROR	500	Erreur interne du serveur