API
결제 알림 나열
앱의 결제 배너가 지금 보여 줄 내용을 급한 순서대로.
GET/billing/alerts
워크스페이스에 실제 호출을 실행합니다.
GET /billing/alerts
앱의 결제 배너가 지금 보여 줄 내용을 급한 순서대로.
예시
billing:read가 필요합니다. kind는 payment_failed, pay_as_you_go_paused, sending_paused, spend_limit_reached, ai_used_up, plan_ending, sends_nearly_used, spend_nearly_reached, upcoming_charge 중 하나이며, target은 요금제에 관한 것인지 사용량에 관한 것인지 알려 줍니다. 빈 목록은 알릴 것이 없다는 뜻입니다.
curl "$OE/billing/alerts" -H "$AUTH"{ "object": "list", "data": [ { "object": "billing_alert", "id": "upcoming_charge:plan:2026-11-01T09:00:00.000Z", "kind": "upcoming_charge", "severity": "info", "target": "billing", "planName": "Business", "at": "2026-11-01T09:00:00.000Z", "cents": 10000, "currency": "usd", "used": null, "limit": null, "payAsYouGo": false } ]}같은 상황이 이어지는 동안 알림은 같은 id를 유지하므로, 누군가 닫은 알림은 닫힌 채로 둘 수 있습니다.
결제에는 워크스페이스 소유자만 닿습니다: API 키, 또는 소유자가 모든 주소로 연결한 액세스 토큰입니다. 멤버의 토큰은 403 owner_only, 특정 주소나 도메인으로 제한된 키나 토큰은 422 capability_unsupported입니다.