Crédits et mentions légales

Chaque demande de clé API aboutie entraîne une consommation de crédits API mensuels. Ce guide explique en quoi consiste le quota, à quel moment il est réinitialisé, ce qui est considéré comme une demande facturable et comment surveiller votre consommation.

Le quota n°

Une fois le quota atteint, toute demande suivante renvoie :

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "success": false,
  "error": "Monthly credit limit reached (20000). Resets next month.",
  "credits": { "used": 20000, "limit": 20000, "remaining": 0 }
}

Le compteur se remet à zéro automatiquement au début du mois civil suivant — aucune intervention n'est nécessaire.

Ce qui compte (et ce qui ne compte pas)#

Chaque appel programmatique facturé par volume tente de prélever 1 crédit avant l'exécution de la tâche principale. Si le serveur rencontre une erreur non interceptée après le prélèvement, le crédit est remboursé: cette erreur ne vous est pas facturée.

Les itinéraires avec compteur comprennent :

• Tous /api/v1/tiktok-shop/* critères d'évaluation.
• GET /api/v1/adlibrary.
• POST /api/v1/magic-ai.
• GET /api/v1/store-tracker, POST /api/v1/store-explorer.
• GET /api/v1/brands.

Sans version /api/adlibrary, /api/store-tracker, et /api/store-explorer sont toujours acceptés comme alias (même mesure). /api/magic-ai et /api/marques sont tableau de bord routes — pour l'utilisation d'une clé API /api/v1/magic-ai et /api/v1/marques.

Avant que des frais ne soient facturés, ces réponses sont renvoyées sans frais (et ne sont pas prises en compte dans la limite du tarif à la minute) :

• 401 Accès non autorisé — clé manquante ou non valide.
• 403 — L'accès à l'API n'est pas activé pour ce compte.

Réponses correctes et la plupart 429 lignes sont enregistrés et pris en compte dans le 60 par minute fenêtre (voir Limites de débit).

Tableau de bord vs API#

L'application de navigation peut appliquer un système de comptage différent de celui des appels directs via la clé API. Pour les intégrations, partez du principe qu'une requête comptabilisée réussie équivaut à 1 crédit, sauf indication contraire dans votre contrat.

Suivi de l'utilisation du crédit#

Programmatique#

curl -sS \
  -H "X-API-Key: $WH_API_KEY" \
  "{origin}/api/v1/tiktok-shop/credits"

Renvoie la même chose { utilisé, limite, restant } la forme que revêt le corps 429. Cela coûte 1 crédit (oui, la vérification du solde coûte un crédit ; mettez-le en cache côté client).

Tableau de bord#

Lorsque vous êtes connecté :

• GET /api — widget des crédits visuels + graphique d'utilisation sur 14 jours + journal des demandes récentes.
• GET /api/usage — JSON : { usage: [{ day, requests }, …], credits: { used, limit, remaining } }.
• GET /api/logs?page=N — Journal des requêtes paginé (50 entrées par page), avec codes d'état et adresses IP.

Ces trois éléments sont des cookies de session. Ils ne consomment pas de crédits.

MCP et générique#

Protocole de contexte de modèle utilise le même cagnotte mensuelle (20 000). Chaque MCP réussi outils/appel frais 1 crédit — y compris des outils tels que générique. initialiser, outils/liste, ping, etc. font pas frais.

Le trafic des outils MCP a ses propre limite de rafales par minute (voir MCP); cela ne remplace pas la section de ce guide consacrée à la limitation du débit REST pour /api/*.

Planification des capacités#

Pour les charges de travail ETL ou de réactualisation continues, basez votre conception sur la capacité journalière, et non sur la capacité par minute. La limite de débit réglemente les pics de trafic (60/min) ; le quota de crédits réglemente le volume (20 000/mois).

Des stratégies pour optimiser vos crédits#

• Lot avec PUBLICATION JSON. Un ensemble de filtres généraux dans une seule requête est plus efficace que plusieurs filtres spécifiques.
• Mettre en cache les requêtes récurrentes. Hiérarchies de catégories, listes de pays, préréglages de filtres : les récupérer au maximum une fois par jour.
• Utilisation compter auparavant découvrir quand un simple chiffre suffit.
• Ne pas interroger générique avec détermination — chaque appel coûte 1 crédit. Suivez l'utilisation côté client à l'aide de votre propre compteur de réponses, puis resynchronisez à partir de /api/v1/tiktok-shop/crédits une fois par heure.

Comportement de réinitialisation#

Le compteur de données est remis à zéro au début de chaque mois civil (UTC) sur le serveur. La première requête comptabilisée au cours d'un nouveau mois déclenche automatiquement la réinitialisation du compteur.

Qu'en est-il des modifications apportées au contrat ?#

• Mise à niveau en cours de mois : votre compteur de crédit actuel continue de tourner ; la limite reste fixée à 20 000 (le quota s'applique par utilisateur, et non par niveau).
• Perte d'accès à l'API: les appels facturés renvoient un code d'erreur 403 jusqu'à ce que l'accès soit rétabli ; les compteurs d'utilisation antérieurs sont généralement reportés si vous réactivez l'accès au cours de la même période — vérifiez-le dans le tableau de bord.
• Pour des volumes plus importants: contactez le service d'assistance afin de convenir d'une limite personnalisée.