الانتقال إلى المحتوى الرئيسي
GET
عرض الأرصدة
تتطلب نقطة النهاية هذه مفتاح API للإدارة. ولا تُقبل مفاتيح Gateway API العادية.

أضف رصيدًا من CLI أو الواجهة البرمجية

يمكن للوكلاء والسكربتات بدء شحن للرصيد باستخدام POST /v1/credits/topups أو CLI. ويوافق شخص دائمًا على الخصم.
  • يحتاج الرمز المميز إلى النطاق billing:write. لا يُمنح افتراضيًا أبدًا: أضفه باستخدام phaseo login --scopes billing:write، أو أدرجه في مفتاح إدارة.
  • تتراوح عمليات الشحن من الواجهة البرمجية أو CLI بين $5 و$500؛ وتُجرى عمليات الشحن الأكبر من لوحة التحكم. يمكن أن يكون لمساحة العمل 5 عمليات شحن في الانتظار في وقت واحد (السادسة تُرجع 429 ‏too_many_pending_topups)، وتنتهي صلاحية كل منها بعد 30 دقيقة.
  • لا توجد بطاقة محفوظة بعد: تتضمن الاستجابة checkout_url. يفتحه مالك أو مسؤول في مساحة العمل ويدفع ببطاقة جديدة تُحفظ لعمليات الشحن اللاحقة.
  • توجد بطاقة محفوظة: يتلقى كل مالك ومسؤول رسالة بريد إلكتروني برابط يُستخدم مرة واحدة. يفتحه أحدهم ويسجّل الدخول ويختار التأكيد ودفع أو رفض. يؤدي التأكيد إلى خصم المبلغ من البطاقة، مع تحقق مصرفي إذا طلبه البنك.
  • استطلع GET /v1/credits/topups/{id} (أو phaseo credits topups get <id>) حتى تصبح قيمة final هي true. يُضاف الرصيد عندما تكون الحالة paid. تأتي الحالات declined وexpired وfailed مع رمز reason: لا تُعد محاولتها تلقائيًا؛ واسأل شخصًا بدلًا من ذلك.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

معلمات الاستعلام

workspace_id
string<uuid>

تجاوز اختياري لمساحة العمل. يجب أن يطابق مساحة العمل التي تمت المصادقة عليها، إلا عند استخدام مستدعٍ داخلي للتحكم.

الاستجابة

معلومات الرصيد

ok
enum<boolean>
مطلوب
الخيارات المتاحة:
true
credits
object
مطلوب
آخر تعديل في ١٦ نوفمبر ٢٠٢٦