Realizzato con l'API di pagamento Agent

L'API Agent Payment consente a un agente AI di gestire e acquistare autonomamente crediti API per conto di un utente. Ciò abilita flussi di lavoro automatizzati in cui l'agente può controllare il saldo dei crediti rimanenti, rivedere i limiti di spesa e ricaricare i crediti tramite il metodo di pagamento Stripe salvato dall'utente, il tutto senza intervento umano.

Tutti e tre gli endpoint sono ospitati su payments.builtwith.com e autenticati con la tua chiave API BuiltWith.

Passa la chiave API dell'agente utilizzando uno dei metodi seguenti. Il parametro di query KEY ha la priorità se vengono forniti entrambi.

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

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

Le richieste con una chiave mancante, non valida o disabilitata restituiscono HTTP 401. Gli account con fatturazione sospesa restituiscono 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.

Dopo l'abilitazione manuale, gli agenti possono utilizzare alias di dominio API compatibili con mppx per l'API di pagamento agente esistente. Questi percorsi utilizzano la stessa autenticazione tramite chiave API BuiltWith, il metodo di pagamento Stripe salvato e i limiti di spesa per la fatturazione API agente descritti di seguito.

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 }

Invia la chiave API dell'agente come intestazione Authorization: Bearer o come parametro di query KEY, esattamente come con gli endpoint dell'API di pagamento dell'agente su payments.builtwith.com.

Restituisce il saldo corrente del credito API per l'account.

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

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

Restituisce i limiti di spesa configurati e la percentuale del budget mensile già utilizzata. L'operatore dovrebbe verificare queste informazioni prima di tentare un acquisto per evitare che le richieste vengano rifiutate.

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
}

Addebita l'importo sul metodo di pagamento Stripe salvato dall'utente e lo accredita immediatamente sul conto. L'acquisto è soggetto ai limiti per singolo acquisto e mensili impostati nella configurazione di fatturazione dell'API dell'agente.

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

Invia la chiave API dell'agente come Authorization: Bearer intestazione o come ?KEY= parametro di query. Il corpo della richiesta deve essere in formato JSON.

{ "credits": 2000 }

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

Si noti che i messaggi di errore in questo formato non possono essere garantiti; l'implementazione dovrebbe considerare anche i codici di risposta diversi da 200 come errori. La proprietà Lookup sarà null (json) o non fornita (xml) se l'errore è correlato al server. Visualizza tutti i potenziali codici di errore ben formati.

Nostro termini standard coprono l'utilizzo di tutte le nostre API.

In generale, puoi utilizzare l'API per migliorare il tuo prodotto in molti modi. L'unica limitazione è che non puoi rivendere i dati così come sono o fornire funzionalità duplicate a builtwith.com e ai suoi servizi associati.