Belgelere geç
API

Faturalandırma uyarılarını listele

Uygulamanın faturalandırma bandının şu anda ne diyeceği, en acili önce.

GET/billing/alerts

Gerçek çağrıyı çalışma alanınızda çalıştırır.

GET /billing/alerts

Uygulamanın faturalandırma bandının şu anda ne diyeceği, en acili önce.

Örnek

billing:read gerektirir. kind payment_failed, pay_as_you_go_paused, sending_paused, spend_limit_reached, ai_used_up, plan_ending, sends_nearly_used, spend_nearly_reached ya da upcoming_charge olur, target ise planla mı kullanımla mı ilgili olduğunu söyler. Boş bir liste söylenecek bir şey olmadığı anlamına gelir.

curl
curl "$OE/billing/alerts" -H "$AUTH"
Yanıt
{  "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    }  ]}

Bir uyarı, aynı durum sürdükçe id değerini korur, bu yüzden birinin kapattığı bir uyarı kapalı kalabilir.

Faturalandırmaya yalnızca çalışma alanının sahibi erişir: bir API anahtarı ya da sahibin her adresle bağladığı bir erişim token’ı. Bir üyenin token’ı 403 owner_only, belirli adreslerle ya da alan adlarıyla sınırlı bir anahtar ya da token ise 422 capability_unsupported döndürür.

Referans