QuotaMint

/v1/consume vérifie l'offre, le droit lié à la fonctionnalité, le coût en crédits et le solde, puis répond allowed: true ou allowed: false. Un refus est une réponse normale, pas une erreur, donc votre application peut afficher une invitation à changer d'offre au lieu d'une trace technique. Le même appel écrit la ligne au grand livre quand il approuve la demande.

/v1/check renvoie la même décision sans réserver ni débiter de crédits. Il sert à griser un bouton, à afficher le solde restant dans les réglages ou à prévenir un client avant une tâche longue. Comme rien n'est écrit, l'appel reste sans risque pendant que la personne réfléchit encore.

Chaque demande de consommation peut porter une clé d'idempotence qui désigne l'opération métier, pas la tentative HTTP. Si une requête expire et que votre serveur la relance avec la même clé, QuotaMint renvoie le résultat d'origine sans débiter une seconde fois. Les requêtes simultanées avec la même clé attendent la fin de la première et reçoivent la réponse enregistrée.

Vous créez des offres comme Starter à 500 crédits par mois et Pro à 2 000, puis fixez un coût par fonctionnalité : 1 crédit pour le texte, 10 pour une image, 50 pour une vidéo. Les droits déterminent les fonctionnalités accessibles à chaque offre. Un changement de prix s'applique à l'appel suivant, sans déploiement.

Les consommations simultanées ne peuvent pas faire passer un solde sous zéro. Si vingt appels se disputent dix crédits à un coût de dix, un seul passe et les dix-neuf autres reviennent refusés avec insufficient_credits. Chaque consommation approuvée laisse une ligne au grand livre, et l'historique indique quand, où et quelle fonctionnalité a dépensé les crédits, ce qui assure le suivi de l'usage API pour le support et la finance.

Chaque projet fournit des clés de test et des clés réelles, comptées séparément dans la limite de l'offre. Les données de test ne se mêlent jamais aux soldes réels, donc un développeur peut répéter une montée d'offre, une rétrogradation ou un solde épuisé contre la vraie API avant de toucher la production.

/v1/events enregistre une consommation mesurée sans coût en crédits, comme un appel d'API, un document traité ou une minute de transcription. Vous mesurez des tokens, des images, des minutes ou vos propres unités et gardez un historique par client. Un produit sans crédits peut tourner uniquement avec des droits et des événements.

Aucune bibliothèque cliente à installer ou à maintenir. Tout langage capable d'envoyer un POST en HTTPS fait l'affaire, TypeScript, Go, Python et Ruby compris, et le corps de requête reste sous 64 KiB par défaut. Votre serveur appelle QuotaMint directement, donc le trafic de l'API ne traverse jamais de proxy.