API Reference - Events Ingestion
توثيق كامل لـ API مع أمثلة ورموز استجابة.
بنية الحدث
Required Fields
Required Fields
Optional Fields
Optional Fields
string
طابع زمني بتنسيق ISO 8601 (بالتوقيت العالمي المنسق UTC). يتم تعيينه افتراضيًا إلى وقت الخادم الحالي إذا لم يتم تضمينه. قم بتضمينه لضمان دقة الفوترة مع الأحداث المؤجلة/المجمعة. يتم رفض الطوابع الزمنية الأقدم من ساعة واحدة أو التي تتجاوز 5 دقائق في المستقبل.
object
خصائص إضافية للتجميع والتصفية:
- القيم الرقمية:
bytes،tokens،duration_ms - عوامل التصفية:
endpoint،method،quality
إرسال الأحداث
مخططات إدخال الأحداث
أنماط أحداث جاهزة لحالات الاستخدام الشائعة. ابدأ بمخطط مُثبت بدلاً من البناء من الصفر.LLM Blueprint
تتبع استخدام رموز AI عبر OpenAI وAnthropic وGroq وGemini وغيرها.
API Gateway Blueprint
قس طلبات API باستخدام تصفية نقاط النهاية ودعم تحديد معدل الطلبات.
Object Storage Blueprint
تتبع عمليات رفع الملفات واستهلاك التخزين لخدمات التخزين السحابي.
Stream Blueprint
قِس عرض النطاق الترددي للبث المرئي والصوتي والبيانات الفورية.
Time Range Blueprint
أصدر الفواتير حسب الوقت المنقضي للوظائف عديمة الخادم ومثيلات الحوسبة.
View All Blueprints
اطّلع على جميع المخططات المتاحة مع أدلة تنفيذ مفصلة.
أفضل الممارسات
Use Unique Event IDs
Use Unique Event IDs
استخدم معرّفات حتمية لمنع التكرارات:
${customerId}_${action}_${timestamp}Implement Retries
Implement Retries
أعد المحاولة عند حدوث أخطاء 5xx باستخدام التراجع الأسي. لا تُعد المحاولة عند حدوث أخطاء 4xx.
Include Timestamps
Include Timestamps
احذفه من الأحداث الفورية. أدرجه في الأحداث المتأخرة/المجمعة لضمان الدقة.
Monitor Delivery
Monitor Delivery
تتبع معدلات النجاح وضع الأحداث الفاشلة في قائمة انتظار لإعادة المحاولة.
استكشاف الأخطاء وإصلاحها
Events not appearing
Events not appearing
- يجب أن يطابق اسم الحدث العداد تماماً (حساس لحالة الأحرف)
- يجب أن يكون معرّف العميل موجوداً
- تحقق من أن عوامل تصفية العداد لا تستبعد الأحداث
- تحقق من أن الطوابع الزمنية حديثة
Authentication errors (401)
Authentication errors (401)
تحقق من صحة API key واستخدم التنسيق:
Bearer YOUR_API_KEYValidation errors (400)
Validation errors (400)
تأكد من وجود جميع الحقول المطلوبة:
event_id، customer_id، event_nameMetadata not aggregating
Metadata not aggregating
- يجب أن تتطابق مفاتيح Metadata تماماً مع قيمة “Over Property” في العداد
- استخدم أرقاماً، وليس سلاسل نصية:
tokens: 150وليسtokens: "150"
الخطوات التالية
Create Meters
حدّد كيفية تجميع أحداثك في كميات قابلة للفوترة باستخدام عوامل التصفية ودوال التجميع.
Ingestion Blueprints
استخدم المخططات الجاهزة لحالات الاستخدام الشائعة مثل تتبع LLM وبوابات API والتخزين.
Complete Tutorial
أنشئ مولّد صور AI متكاملاً مع فوترة قائمة على الاستخدام من الصفر.
API Reference
توثيق كامل لـ API يتضمن جميع المعلمات ورموز الاستجابة والاختبار التفاعلي.