پرش به مستندات
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
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 است.

مرجع