Realizzato con l'API di pagamento Agent

Introduzione

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.

Prima che un agente possa utilizzare questi endpoint, l'utente deve abilitare la fatturazione API dell'agente e configurare i limiti di spesa su https://payments.builtwith.com/agent-payment-api-config.

Autenticazione

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

Intestazione di autorizzazione (consigliata)

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

Parametro di query (fallback)

?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.

🤖 Richiesta dell'agente AI

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.

GET /v1/billing/api-discovery — Saldo a credito

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

Richiesta

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

Campi di risposta

Campo	Tipo	Descrizione
`credits_total`	`number`	Totale dei crediti mai accreditati sul conto.
`credits_used`	`number`	Crediti consumati dalle chiamate API fino ad oggi.
`credits_available`	`number`	Crediti utilizzabili rimanenti (totale meno utilizzati). Questo è ciò che l'agente dovrebbe verificare prima di effettuare chiamate API.

Esempio di risposta

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

GET /v1/billing/api-configuration — Limiti di spesa

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.

Richiesta

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

Campi di risposta

Campo	Tipo	Descrizione
`max_per_purchase`	`number`	Numero massimo di crediti che l'agente può acquistare in una singola transazione.
`max_monthly`	`number`	Numero massimo di crediti che l'agente può acquistare nel corso del mese solare in corso.
`monthly_purchased`	`number`	Crediti già acquistati dall'agente in questo mese solare.
`monthly_remaining`	`number`	Quanti altri crediti è possibile acquistare questo mese prima di raggiungere il limite mensile?
`cost_per_2000_credits_usd`	`number`	Costo in USD per un acquisto minimo di 2.000 crediti. Utilizza questo dato per stimare il costo di un acquisto pianificato.

Esempio di risposta

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

POST /v1/billing/api-purchase — Acquista crediti

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.

Richiesta

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.

Corpo della richiesta

Campo	Tipo	Necessario	Descrizione
`credits`	`number`	SÌ	Numero di crediti da acquistare. Minimo 2.000. Non deve superare `max_per_purchase` o l'indennità mensile rimanente.

Risposta di successo (HTTP 200)

Campo	Tipo	Descrizione
`success`	`boolean`	`true`
`credits_purchased`	`number`	Crediti aggiunti all'account.
`cost_usd`	`number`	Importo addebitato in USD.
`payment_id`	`string`	ID di Stripe PaymentIntent per la riconciliazione.
`credits_available`	`number`	Saldo del credito disponibile aggiornato dopo l'acquisto.

Esempio di corpo della richiesta

{ "credits": 2000 }

Esempio di risposta positiva

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

Risposte di errore

HTTP	Senso
400	Errore di convalida: crediti inferiori a 2.000, superamento del limite per singolo acquisto o superamento del limite mensile.
401	Chiave API dell'agente mancante o non valida.
402	Il pagamento tramite Stripe non è andato a buon fine oppure non è presente alcun metodo di pagamento valido nei nostri archivi.
403	Fatturazione dell'account sospesa.
405	Metodo non consentito: l'endpoint richiede il metodo POST.

Domini speciali

Manteniamo due elenchi utili per la ricerca di domini: gli elenchi "Ignora" e gli elenchi "BuiltWith Suffix".

Elenco ignorati
TQuesto è il nostro elenco interno di domini che non indicizziamo. Sono bloccati, contengono troppe tecnologie fuorvianti o troppi sottodomini con contenuti generati dagli utenti.

BuiltWith Elenco dei suffissi
Questo si basa sul Elenco dei suffissi pubblici ma include molte voci aggiuntive per le aziende con sottodomini che dovrebbero essere considerati domini di primo livello. Questo elenco ci garantisce una migliore visibilità per i siti web interni, ad esempio porta northernbeaches.nsw.gov.au al primo posto rispetto a nsw.gov.au.

Ignora domini (XML, JSON or TXT)

https://api.builtwith.com/ignoresv1/api.json

Domini suffissi (XML, JSON or TXT)

https://api.builtwith.com/suffixv1/api.json

Codici di errore

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.

Termini di utilizzo

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.