API
سرد الدفعات
كل دفعات مساحة العمل، كلٌّ منها مع فاتورتها.
GET/billing/invoices
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
GET /billing/invoices
كل دفعات مساحة العمل، كلٌّ منها مع فاتورتها.
مثال
يتطلب billing:read. هو السجل في الخطط والفوترة. يتصفّح page وlimit الدفعات، وsort هو newest أو oldest، ويبحث search في الخطة ورقم الفاتورة ومعرّف الدفعة والاسم المفوتر.
curl "$OE/billing/invoices?limit=10" -H "$AUTH"{ "object": "list", "data": [ { "object": "invoice", "id": "8c51f0d2-3b7e-4a19-b6c4-0e9d2f7a1c38", "createdAt": "2026-10-01T09:00:12.000Z", "amountCents": 10000, "subtotalCents": 10000, "currency": "usd", "status": "paid", "paid": true, "reason": "subscription_cycle", "invoiceNumber": "ACME-0007", "invoiceReady": true, "needsBillingDetails": false, "billingName": "Acme Ltd", "product": "Business", "payAsYouGo": false, "discount": null } ], "total": 7, "page": 1, "limit": 10, "hasMore": false, "metered": true}يعني needsBillingDetails أن الفاتورة تحتاج أولًا إلى اسم وعنوان فوترة، يحفظهما PUT /billing/invoices/{orderId}/details.
لا يصل إلى الفوترة إلا مالك مساحة العمل: مفتاح API، أو رمز وصول ربطه المالك بكل العناوين. رمز العضو يعيد 403 owner_only، والمفتاح أو الرمز المقيّد بعناوين أو نطاقات معيّنة يعيد 422 capability_unsupported.