تخطَّ إلى المستندات
API

سرد الدفعات

كل دفعات مساحة العمل، كلٌّ منها مع فاتورتها.

GET/billing/invoices

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

GET /billing/invoices

كل دفعات مساحة العمل، كلٌّ منها مع فاتورتها.

مثال

يتطلب billing:read. هو السجل في الخطط والفوترة. يتصفّح page وlimit الدفعات، وsort هو newest أو oldest، ويبحث search في الخطة ورقم الفاتورة ومعرّف الدفعة والاسم المفوتر.

curl
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.

المرجع