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.