مرجع API - استيعاب الأحداث
وثائق API كاملة مع أمثلة وأكواد استجابة.
هيكل الحدث
الحقول المطلوبة
الحقول المطلوبة
معرف فريد. استخدم UUIDs أو اجمع بين معرف العميل + الطابع الزمني + الإجراء.
معرف عميل Dodo Payments. يجب أن يكون عميلًا موجودًا صالحًا.
نوع الحدث الذي يتطابق مع اسم حدث العداد الخاص بك (حساس لحالة الأحرف). أمثلة:
api.call, image.generatedالحقول الاختيارية
الحقول الاختيارية
إرسال الأحداث
مخططات الاستيعاب
أنماط الأحداث الجاهزة للحالات الشائعة. ابدأ بمخطط مثبت بدلاً من البناء من الصفر.مخطط LLM
تتبع استخدام رموز الذكاء الاصطناعي عبر OpenAI وAnthropic وGroq وGemini والمزيد.
مخطط بوابة API
قياس طلبات API مع دعم تصفية النقاط وحدود المعدل.
مخطط تخزين الكائنات
تتبع تحميلات الملفات واستهلاك التخزين لخدمات التخزين السحابية.
مخطط البث
قياس عرض النطاق الترددي للبث للفيديو والصوت والبيانات في الوقت الحقيقي.
مخطط نطاق الوقت
الفوترة حسب الوقت المنقضي لوظائف بدون خادم وحالات الحوسبة.
عرض جميع المخططات
اطلع على جميع المخططات المتاحة مع أدلة تنفيذ مفصلة.
أفضل الممارسات
استخدم معرفات أحداث فريدة
استخدم معرفات أحداث فريدة
استخدم معرفات حتمية لمنع التكرار:
${customerId}_${action}_${timestamp}تنفيذ إعادة المحاولة
تنفيذ إعادة المحاولة
أعد المحاولة عند حدوث أخطاء 5xx مع زيادة زمن الانتظار. لا تعيد المحاولة عند حدوث أخطاء 4xx.
تضمين الطوابع الزمنية
تضمين الطوابع الزمنية
تجاهل للأحداث في الوقت الحقيقي. قم بتضمينها للأحداث المتأخرة/الدفعات للدقة.
مراقبة التسليم
مراقبة التسليم
تتبع معدلات النجاح وقم بتجميع الأحداث الفاشلة لإعادة المحاولة.
استكشاف الأخطاء وإصلاحها
الأحداث لا تظهر
الأحداث لا تظهر
- يجب أن يتطابق اسم الحدث تمامًا مع العداد (حساس لحالة الأحرف)
- يجب أن يكون معرف العميل موجودًا
- تحقق من أن فلاتر العداد لا تستبعد الأحداث
- تحقق من أن الطوابع الزمنية حديثة
أخطاء المصادقة (401)
أخطاء المصادقة (401)
تحقق من أن مفتاح API صحيح واستخدم التنسيق:
Bearer YOUR_API_KEYأخطاء التحقق (400)
أخطاء التحقق (400)
تأكد من وجود جميع الحقول المطلوبة:
event_id, customer_id, event_nameالبيانات الوصفية لا تتجمع
البيانات الوصفية لا تتجمع
- يجب أن تتطابق مفاتيح البيانات الوصفية مع “الخاصية الزائدة” للعداد تمامًا
- استخدم الأرقام، وليس السلاسل:
tokens: 150وليسtokens: "150"
الخطوات التالية
إنشاء العدادات
حدد كيفية تجميع أحداثك في كميات قابلة للفوترة مع الفلاتر ووظائف التجميع.
مخططات الاستيعاب
استخدم المخططات الجاهزة للحالات الشائعة مثل تتبع LLM، وبوابات API، والتخزين.
الدليل الكامل
قم ببناء مولد صور AI كامل مع فوترة معتمدة على الاستخدام من الصفر.
مرجع API
وثائق API كاملة مع جميع المعلمات، أكواد الاستجابة، واختبار تفاعلي.