الحصول على قائمة طلبات منصة AceDataCloud

إرجاع طلبات شحن رصيد الحساب على شكل صفحات، وهو مناسب للعثور على معرّف الطلب، وعرض حالة الدفع، وتسوية الحسابات.

التحضير

أنشئ Account Token، واحصل على UUID الحساب الحالي من GET /api/v1/platform-tokens/me/.

export PLATFORM_TOKEN='رمز الحساب الخاص بك'
export USER_ID='UUID الحساب الخاص بك'

نظرة عامة على الواجهة

البند	المحتوى
الطريقة	`GET`
URL	`https://platform.acedata.cloud/api/v1/orders/`
المصادقة	Account Token، يتطلب OAuth token صلاحية `orders:read`
الترقيم	`count` + `items`

يجب على المستخدمين العاديين تمرير user_id الخاص بهم؛ وإلا فقد يتم إرجاع 403 عند مواجهة كائنات غير مصرح بها أثناء الترقيم.

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

المعامل	النوع	مطلوب	الوصف
`user_id`	UUID	مطلوب للمستخدمين العاديين	الحساب الذي ينتمي إليه الطلب؛ يدعم تكرار المعامل
`pay_way`	string	لا	التصفية حسب طريقة الدفع؛ يدعم القيم المكررة أو المفصولة بفواصل
`state`	string	لا	التصفية حسب الحالة؛ يدعم القيم المكررة أو المفصولة بفواصل
`created_at_from/to`	datetime	لا	نطاق وقت الإنشاء
`finished_at_from/to`	datetime	لا	نطاق وقت الإكمال
`limit` / `offset`	integer	لا	الترقيم
`ordering`	string	لا	`created_at`، أو `-created_at`، أو `finished_at`، أو `-finished_at`

لا تدعم القائمة الحالية التصفية حسب application_id أو service_id أو package_id أو payment_method أو tag؛ واسم حقل طريقة الدفع هو pay_way.

curl --get 'https://platform.acedata.cloud/api/v1/orders/' \
  --data-urlencode "user_id=${USER_ID}" \
  --data-urlencode 'state=Paid,Finished' \
  --data-urlencode 'pay_way=Stripe' \
  --data-urlencode 'limit=100' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"

توضيح الاستجابة

الاستجابة هي {count, items}. تتضمن عناصر القائمة المباشرة id وuser_id وapplication_id/application_ids وpackage_id/package_ids وprice وamount وdiscount وremaining_amount وstate وpay_way وpay_id وpay_url وfinished_at وexpired_at وinvoice وmetadata وحقول الوقت.

الحالات الفعلية هي Pending وPaid وFinished وExpired وFailed وRefunded، ولا توجد Cancelled.
أسماء الحقول هي pay_way وfinished_at وdiscount وprice، وليست payment_method أو paid_at أو discount_rate أو final_price.
price هو السعر النهائي المسجل للطلب؛ وقد تكون تفاصيل العملة والتسوية ضمن metadata خاضعة للتحكم، ولا يمكن استنتاجها ذاتيًا من طريقة الدفع فقط.

البداية

دردشة الذكاء الاصطناعي

صورة الذكاء الاصطناعي

فيديو الذكاء الاصطناعي

الصوت الذكي

الويب والبيانات

CAPTCHA

الهوية

Coding

المزيد من الأدلة

الحصول على قائمة طلبات منصة AceDataCloud

التحضير

نظرة عامة على الواجهة

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

توضيح الاستجابة

الواجهات ذات الصلة

​التحضير

​نظرة عامة على الواجهة

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

​توضيح الاستجابة

​الواجهات ذات الصلة

التحضير

نظرة عامة على الواجهة

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

توضيح الاستجابة

الواجهات ذات الصلة