에이전트 거래 API

소개

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

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

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

수동으로 활성화한 후에는 mppx 호환 에이전트도 동일한 에이전트 결제 API 작업에 대해 API 도메인 별칭을 사용할 수 있습니다. https://api.builtwith.com/mppx. 이러한 별칭은 기존 에이전트 결제 API, 동일한 BuiltWith API 키 인증 및 동일하게 구성된 지출 한도를 사용합니다.

입증

아래 두 가지 방법 중 하나를 사용하여 에이전트 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.
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.

mppx Agent Payment API Aliases

수동으로 활성화하면 상담원은 기존 상담원 결제 API에 대해 mppx 호환 API 도메인 별칭을 사용할 수 있습니다. 이러한 경로는 아래에 설명된 것과 동일한 BuiltWith API 키 인증, 저장된 Stripe 결제 방식 및 상담원 API 청구 지출 한도를 사용합니다.

발견

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 }

payments.builtwith.com의 에이전트 결제 API 엔드포인트와 마찬가지로, 에이전트 API 키를 Authorization: Bearer 헤더 또는 KEY 쿼리 매개변수로 전송하십시오.

GET /v1/billing/api-discovery — 신용 잔액

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

요구

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

응답 필드

필드	유형	설명
`credits_total`	`number`	계정에 할당된 총 크레딧 수입니다.
`credits_used`	`number`	현재까지 API 호출에 사용된 크레딧입니다.
`credits_available`	`number`	남은 사용 가능 크레딧(총 크레딧에서 사용량을 뺀 값). 상담원은 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_purchase`	`number`	에이전트가 한 번의 거래에서 구매할 수 있는 최대 크레딧 수.
`max_monthly`	`number`	에이전트가 해당 월에 구매할 수 있는 최대 크레딧 수입니다.
`monthly_purchased`	`number`	해당 에이전트가 이번 달에 이미 구매한 크레딧입니다.
`monthly_remaining`	`number`	이번 달 한도에 도달하기 전에 몇 개의 크레딧을 더 구매할 수 있나요?
`cost_per_2000_credits_usd`	`number`	최소 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 형식이어야 합니다.

요청 본문

필드	유형	필수의	설명
`credits`	`number`	예	구매하실 크레딧 수. 최소 2,000개. 초과할 수 없습니다. `max_per_purchase` 또는 남은 월별 용돈.

성공 응답(HTTP 200)

필드	유형	설명
`success`	`boolean`	`true`
`credits_purchased`	`number`	계정에 크레딧이 추가되었습니다.
`cost_usd`	`number`	청구 금액은 미화(USD)입니다.
`payment_id`	`string`	결제 정산을 위한 Stripe PaymentIntent ID.
`credits_available`	`number`	구매 후 업데이트된 사용 가능한 신용 잔액입니다.

예시 요청 본문

{ "credits": 2000 }

성공 응답 예시

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

오류 응답

HTTP	의미
400	유효성 검사 실패 - 크레딧이 2,000 미만이거나, 구매당 한도를 초과했거나, 월별 한도를 초과했습니다.
401	에이전트 API 키가 없거나 유효하지 않습니다.
402	Stripe 결제가 실패했거나 결제 가능한 결제 수단이 등록되어 있지 않습니다.
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 및 관련 서비스에 중복된 기능을 제공할 수 없습니다.