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

API Reference - Events Ingestion

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

بنية الحدث

string
مطلوب
معرّف فريد. استخدم UUIDs أو ادمج معرّف العميل + الطابع الزمني + الإجراء.
string
مطلوب
Dodo Payments معرّف العميل. يجب أن يكون عميلاً موجوداً وصالحاً.
string
مطلوب
نوع الحدث الذي يطابق اسم حدث العداد (حساس لحالة الأحرف). أمثلة: api.call، image.generated
string
طابع زمني بتنسيق ISO 8601 (بالتوقيت العالمي المنسق UTC). يتم تعيينه افتراضيًا إلى وقت الخادم الحالي إذا لم يتم تضمينه. قم بتضمينه لضمان دقة الفوترة مع الأحداث المؤجلة/المجمعة. يتم رفض الطوابع الزمنية الأقدم من ساعة واحدة أو التي تتجاوز 5 دقائق في المستقبل.
object
خصائص إضافية للتجميع والتصفية:
  • القيم الرقمية: 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 باستخدام التراجع الأسي. لا تُعد المحاولة عند حدوث أخطاء 4xx.
احذفه من الأحداث الفورية. أدرجه في الأحداث المتأخرة/المجمعة لضمان الدقة.
تتبع معدلات النجاح وضع الأحداث الفاشلة في قائمة انتظار لإعادة المحاولة.

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

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

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

Create Meters

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

Ingestion Blueprints

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

Complete Tutorial

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

API Reference

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