Skip to main content
تُعد الأحداث أساس الفوترة القائمة على الاستخدام. أرسل الأحداث عند وقوع الإجراءات القابلة للفوترة، وتعمل العدادات على تجميعها وتحويلها إلى رسوم.

API Reference — Events Ingestion

توثيق كامل لـ API مع أمثلة ورموز الاستجابة.

بنية الحدث

string
مطلوب
معرّف فريد للحدث، يُستخدم لاكتشاف الأحداث المكررة عند إعادة المحاولة. اشتقه من الإجراء، على سبيل المثال: معرّف العميل + الإجراء + الطابع الزمني، بحيث يحتفظ الحدث المُعادّت محاولته بالمعرّف نفسه. إن إنشاء UUID عشوائي جديد في كل إعادة محاولة يتيح احتساب الحدث نفسه مرتين.
string
مطلوب
معرّف عميل Dodo Payments. يجب أن يكون معرّف عميل موجودًا وصالحًا.
string
مطلوب
نوع الحدث الذي يطابق اسم الحدث في meter لديك (مع مراعاة حالة الأحرف). أمثلة: api.call، image.generated.
string
طابع زمني بتنسيق ISO 8601 (UTC). يُستخدم وقت الخادم الحالي تلقائيًا إذا لم تُحدده. أدرجه لضمان دقة الفوترة مع الأحداث المؤجلة أو المجمّعة. يتم رفض الطوابع الزمنية الأقدم من ساعة واحدة أو التي تتجاوز 5 دقائق في المستقبل.
object
خصائص إضافية للتجميع والتصفية. بحد أقصى 50 مفتاحًا؛ ويمكن أن يصل طول كل مفتاح إلى 100 حرف، وكل قيمة إلى 500 حرف.
  • القيم الرقمية: bytes، tokens، duration_ms
  • عوامل التصفية: endpoint، method، quality

إرسال الأحداث

يمكن تجميع ما يصل إلى 1,000 حدث لكل طلب لتحسين الأداء. يفرض API حدًا أقصى صارمًا يبلغ 1,000 حدث لكل طلب.

مخططات إدخال الأحداث

أنماط أحداث جاهزة لحالات الاستخدام الشائعة. ابدأ بمخطط مُثبت بدلاً من البناء من الصفر.

LLM Blueprint

تتبع استخدام رموز AI عبر OpenAI وAnthropic وGroq وGemini وغيرها.

API Gateway Blueprint

قس طلبات API باستخدام تصفية نقاط النهاية ودعم تحديد معدل الطلبات.

Object Storage Blueprint

تتبع عمليات رفع الملفات واستهلاك التخزين لخدمات التخزين السحابي.

Stream Blueprint

قِس عرض النطاق الترددي للبث المرئي والصوتي والبيانات الفورية.

Time Range Blueprint

أصدر الفواتير حسب الوقت المنقضي للوظائف عديمة الخادم ومثيلات الحوسبة.

View All Blueprints

اطّلع على جميع المخططات المتاحة مع أدلة تنفيذ مفصلة.

أفضل الممارسات

استخدم معرّفات حتمية لمنع التكرارات: ${customerId}_${action}_${timestamp}.
أعد المحاولة عند حدوث أخطاء 5xx وأخطاء 429 مع استخدام التأخير الأُسّي. لا تُعد المحاولة عند حدوث أخطاء 4xx الأخرى.
احذف الطوابع الزمنية للأحداث في الوقت الفعلي. أدرجها للأحداث المؤجلة أو المجمّعة لضمان الدقة.
تتبع معدلات النجاح وضع الأحداث الفاشلة في قائمة انتظار لإعادة المحاولة.

استكشاف الأخطاء وإصلاحها

  • يجب أن يطابق اسم الحدث meter تمامًا (مع مراعاة حالة الأحرف)
  • يجب أن يكون معرّف العميل موجودًا في حسابك
  • تحقّق من أن فلاتر meter لا تستبعد الأحداث
  • تحقّق من حداثة الطوابع الزمنية
تحقّق من صحة API key واستخدم التنسيق: Bearer YOUR_API_KEY.
تأكّد من وجود جميع الحقول المطلوبة: event_id، customer_id، event_name.
  • يجب أن تطابق مفاتيح Metadata قيمة “Over Property” في meter تمامًا
  • استخدم أرقامًا، وليس سلاسل نصية: tokens: 150 وليس tokens: "150"

الخطوات التالية

Create Meters

حدّد كيفية تجميع أحداثك في كميات قابلة للفوترة باستخدام عوامل التصفية ودوال التجميع.

Ingestion Blueprints

استخدم المخططات الجاهزة لحالات الاستخدام الشائعة مثل تتبع LLM وبوابات API والتخزين.

Complete Tutorial

أنشئ مولّد صور AI متكاملاً مع فوترة قائمة على الاستخدام من الصفر.

API Reference

توثيق كامل لـ API يتضمن جميع المعلمات ورموز الاستجابة والاختبار التفاعلي.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦