Agent API de paiement

L'API de paiement pour agents permet à un agent IA de gérer et d'acheter des crédits API de manière autonome pour le compte d'un utilisateur. Ceci permet des flux de travail automatisés où l'agent peut consulter son solde de crédits, vérifier les limites de dépenses et recharger ses crédits via le moyen de paiement Stripe enregistré par l'utilisateur, le tout sans intervention humaine.

Les trois points de terminaison sont hébergés sur payments.builtwith.com et authentifiez-vous avec votre clé API BuiltWith.

Transmettez la clé API de l'agent en utilisant l'une des méthodes ci-dessous. Si les deux paramètres sont fournis, le paramètre de requête KEY est prioritaire.

Authorization: Bearer 00000000-0000-0000-0000-000000000000

?KEY=00000000-0000-0000-0000-000000000000

Les requêtes comportant une clé manquante, invalide ou désactivée renvoient une erreur HTTP 401. Les comptes dont la facturation est suspendue renvoient une erreur HTTP 403.

Reference https://api.builtwith.com/llms.txt and
https://raw.githubusercontent.com/builtwith/builtwith-ai-sdk/refs/heads/main/README.md
Add BuiltWith Agent Payment API support to my app. Check the current API credit balance,
and if below 1000 credits, purchase 2000 more using the Agent Payment API.
If mppx aliases have been manually enabled for this workflow, use
https://api.builtwith.com/mppx/openapi.json and the Agent Payment API routes
https://api.builtwith.com/mppx/api-discovery,
https://api.builtwith.com/mppx/api-configuration, and
https://api.builtwith.com/mppx/api-purchase.

Après activation manuelle, les agents peuvent utiliser des alias de domaine d'API compatibles mppx pour l'API de paiement des agents existante. Ces routes utilisent la même authentification par clé API BuiltWith, la même méthode de paiement Stripe enregistrée et les mêmes limites de dépenses de facturation de l'API des agents, décrites ci-dessous.

GET https://api.builtwith.com/mppx/openapi.json

GET https://api.builtwith.com/mppx/api-discovery

GET https://api.builtwith.com/mppx/api-configuration

POST https://api.builtwith.com/mppx/api-purchase

{ "credits": 2000 }

Envoyez la clé API de l'agent en tant qu'en-tête Authorization: Bearer ou en tant que paramètre de requête KEY, exactement comme avec les points de terminaison de l'API de paiement de l'agent sur payments.builtwith.com.

Renvoie le solde créditeur API actuel du compte.

GET https://payments.builtwith.com/v1/billing/api-discovery?KEY=00000000-0000-0000-0000-000000000000

{
  "credits_total": 10000,
  "credits_used": 1234,
  "credits_available": 8766
}

Renvoie les limites de dépenses configurées et le montant de l'allocation mensuelle déjà utilisé. L'agent doit vérifier ces informations avant de tenter un achat afin d'éviter les demandes rejetées.

GET https://payments.builtwith.com/v1/billing/api-configuration?KEY=00000000-0000-0000-0000-000000000000

{
  "max_per_purchase": 5000,
  "max_monthly": 20000,
  "monthly_purchased": 5000,
  "monthly_remaining": 15000,
  "cost_per_2000_credits_usd": 99.00
}

Le paiement est débité du mode de paiement Stripe enregistré de l'utilisateur et son compte est immédiatement crédité. Cet achat est soumis aux limites par achat et mensuelles définies dans la configuration de facturation de l'API Agent.

POST https://payments.builtwith.com/v1/billing/api-purchase

Envoyez la clé API de l'agent comme Authorization: Bearer en-tête ou comme un ?KEY= Paramètre de requête. Le corps de la requête doit être au format JSON.

{ "credits": 2000 }

{
  "success": true,
  "credits_purchased": 2000,
  "cost_usd": 99.00,
  "payment_id": "pi_3abc123xyz",
  "credits_available": 10766
}

Notez que les messages d'erreur dans ce format ne peuvent pas être garantis, votre implémentation doit également considérer les codes de réponse non 200 comme des erreurs. La propriété Lookup sera nulle (json) ou non fournie (xml) si l'erreur est liée au serveur. Afficher tous les codes d'erreur potentiels bien formés.

Notre conditions générales couvrir l'utilisation de toutes nos API.

En général, vous pouvez utiliser l'API pour améliorer votre produit de nombreuses façons. La seule limitation est que vous ne pouvez pas revendre les données en l'état ni fournir des fonctionnalités dupliquées à builtwith.com et ses services associés.