에이전트 거래 API

로그인 가입하기
소개

에이전트 결제 API를 사용하면 AI 에이전트가 사용자를 대신하여 API 크레딧을 자율적으로 관리하고 구매할 수 있습니다. 이를 통해 에이전트는 사람의 개입 없이도 남은 크레딧 잔액을 확인하고, 지출 한도를 검토하고, 사용자가 저장한 Stripe 결제 수단을 통해 크레딧을 충전할 수 있는 무인 워크플로우를 구현할 수 있습니다.

세 개의 엔드포인트 모두 다음 위치에 호스팅됩니다. payments.builtwith.com BuiltWith API 키로 인증하세요.

상담원이 이러한 엔드포인트를 사용하려면 먼저 상담원 API 결제를 활성화하고 지출 한도를 설정해야 합니다. https://payments.builtwith.com/agent-payment-api-config.
입증

아래 두 가지 방법 중 하나를 사용하여 에이전트 API 키를 전달하세요. 두 가지 방법 모두 제공되는 경우 KEY 쿼리 매개변수가 우선 적용됩니다.

인증 헤더(권장)

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

쿼리 매개변수(대체값)

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

키가 누락되었거나, 유효하지 않거나, 비활성화된 요청은 HTTP 401 오류를 반환합니다. 결제가 중단된 계정은 HTTP 403 오류를 반환합니다.

🤖 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 — 신용 잔액

해당 계정의 현재 API 크레딧 잔액을 반환합니다.

요구

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

응답 필드
필드유형설명
credits_totalnumber계정에 할당된 총 크레딧 수입니다.
credits_usednumber현재까지 API 호출에 사용된 크레딧입니다.
credits_availablenumber남은 사용 가능 크레딧(총 크레딧에서 사용량을 뺀 값). 상담원은 API 호출을 하기 전에 이 값을 확인해야 합니다.
예시 답변
{
  "credits_total": 10000,
  "credits_used": 1234,
  "credits_available": 8766
}
GET /v1/billing/api-configuration — 지출 한도

설정된 지출 한도와 월별 허용량 중 이미 사용된 금액을 반환합니다. 상담원은 구매를 시도하기 전에 이 값을 확인하여 요청 거절을 방지해야 합니다.

요구

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

응답 필드
필드유형설명
max_per_purchasenumber에이전트가 한 번의 거래에서 구매할 수 있는 최대 크레딧 수.
max_monthlynumber에이전트가 해당 월에 구매할 수 있는 최대 크레딧 수입니다.
monthly_purchasednumber해당 에이전트가 이번 달에 이미 구매한 크레딧입니다.
monthly_remainingnumber이번 달 한도에 도달하기 전에 몇 개의 크레딧을 더 구매할 수 있나요?
cost_per_2000_credits_usdnumber최소 2,000크레딧 구매 시의 미화 비용입니다. 이 정보를 활용하여 계획된 구매 비용을 예상해 보세요.
예시 답변
{
  "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 — 크레딧 구매

사용자가 저장한 Stripe 결제 수단으로 요금이 청구되고 즉시 계정에 입금됩니다. 구매는 에이전트 API 결제 설정에서 지정된 구매당 및 월별 한도에 따라 제한됩니다.

요구

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

에이전트 API 키를 다음과 같이 전송하세요. Authorization: Bearer 헤더 또는 그 외의 용도로 ?KEY= 쿼리 매개변수입니다. 요청 본문은 JSON 형식이어야 합니다.

요청 본문
필드유형필수의설명
creditsnumber예구매하실 크레딧 수. 최소 2,000개. 초과할 수 없습니다. max_per_purchase 또는 남은 월별 용돈.
성공 응답(HTTP 200)
필드유형설명
successbooleantrue
credits_purchasednumber계정에 크레딧이 추가되었습니다.
cost_usdnumber청구 금액은 미화(USD)입니다.
payment_idstring결제 정산을 위한 Stripe PaymentIntent ID.
credits_availablenumber구매 후 업데이트된 사용 가능한 신용 잔액입니다.
예시 요청 본문
{ "credits": 2000 }
성공 응답 예시
{
  "success": true,
  "credits_purchased": 2000,
  "cost_usd": 99.00,
  "payment_id": "pi_3abc123xyz",
  "credits_available": 10766
}
오류 응답
HTTP의미
400유효성 검사 실패 - 크레딧이 2,000 미만이거나, 구매당 한도를 초과했거나, 월별 한도를 초과했습니다.
401에이전트 API 키가 없거나 유효하지 않습니다.
402Stripe 결제가 실패했거나 결제 가능한 결제 수단이 등록되어 있지 않습니다.
403계정 청구가 중단되었습니다.
405허용되지 않는 메서드입니다. 해당 엔드포인트는 POST 방식을 요구합니다.
특수 도메인

도메인을 검색할 때 유용한 두 가지 목록이 있습니다. Ignore 목록과 BuiltWith Suffix 목록입니다.

무시 목록
T이는 저희가 인덱싱하지 않는 내부 도메인 목록입니다. 이 도메인들은 차단되었거나, 오해의 소지가 있는 기술을 너무 많이 포함하고 있거나, 사용자가 생성한 콘텐츠가 포함된 하위 도메인이 너무 많습니다.

BuiltWith 접미사 목록
이는 다음을 기반으로 합니다. 공개 접미사 목록 하지만 최상위 도메인으로 간주되어야 하는 하위 도메인이 있는 회사에 대한 많은 추가 항목이 포함되어 있습니다. 이 목록은 내부 웹사이트에 대한 가시성을 높여줍니다. 예를 들어 northernbeaches.nsw.gov.au가 nsw.gov.au보다 최상위에 위치하게 됩니다.

도메인 무시 (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
접미사 도메인 (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
오류 코드

이 형식의 오류 메시지는 보장할 수 없으며, 구현 시 200이 아닌 응답 코드도 오류로 간주해야 합니다. 오류가 서버 관련이면 Lookup 속성은 null(json)이 되거나 제공되지 않습니다(xml). 모든 잠재적인 잘 구성된 오류 코드 보기.

이용 약관

우리의 표준 용어 모든 API를 사용하는 것을 포함합니다.

일반적으로 API를 사용하여 제품을 다양한 방식으로 개선할 수 있습니다. 단, 데이터를 있는 그대로 재판매하거나 builtwith.com 및 관련 서비스에 중복된 기능을 제공할 수 없습니다.