API
قراءة الدفع حسب الاستخدام
هل يُفوتر الاستخدام الذي يتجاوز الحصص، وكم كلّف حتى الآن.
GET/billing/pay-as-you-go
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
GET /billing/pay-as-you-go
هل يُفوتر الاستخدام الذي يتجاوز الحصص، وكم كلّف حتى الآن.
مثال
يتطلب billing:read. المبالغ بالسنت الأمريكي. limits هي الحدود الشهرية التي يمكن اختيارها، وprices ما يكلّفه الاستخدام الإضافي، وperiod فترة الفوترة الحالية للدفع حسب الاستخدام، وتكون null إلى أن يُعَدّ.
curl "$OE/billing/pay-as-you-go" -H "$AUTH"{ "object": "pay_as_you_go", "available": true, "enabled": true, "suspended": false, "enrolled": true, "switchedOn": true, "coversSends": true, "coversAiActions": true, "limitCents": 5000, "spentCents": 120, "extraSends": 3000, "extraAiActions": 0, "estimatedCents": 120, "limits": [1000, 2500, 5000, 10000, 25000, 50000, 100000, 250000, 500000], "prices": { "sends": { "unit": 1000, "priceCents": 40 }, "aiActions": { "unit": 100, "priceCents": 25 } }, "period": { "endsAt": "2026-11-01T09:00:00.000Z", "sends": 3000, "aiActions": 0, "estimatedCents": 120 }}يكون enabled بقيمة true ما دام الاستخدام الإضافي يُفوتر: مشغَّل وغير متوقف مؤقتًا. ويعني suspended أن آخر دفعة فشلت، وتُحدَّث البطاقة من بوابة الفوترة.
لا يصل إلى الفوترة إلا مالك مساحة العمل: مفتاح API، أو رمز وصول ربطه المالك بكل العناوين. رمز العضو يعيد 403 owner_only، والمفتاح أو الرمز المقيّد بعناوين أو نطاقات معيّنة يعيد 422 capability_unsupported.