Skip to main content
इवेंट उपयोग-आधारित बिलिंग की नींव हैं। बिल योग्य क्रियाएँ होने पर इवेंट भेजें, और मीटर उन्हें चार्ज में संचित करते हैं।

API Reference - Events Ingestion

उदाहरणों और प्रतिक्रिया कोड के साथ पूर्ण API दस्तावेज़।

इवेंट संरचना

string
आवश्यक
विशिष्ट पहचानकर्ता। UUID का उपयोग करें या ग्राहक ID + टाइमस्टैम्प + क्रिया को मिलाएं।
string
आवश्यक
Dodo Payments ग्राहक ID। यह एक वैध मौजूदा ग्राहक होना चाहिए।
string
आवश्यक
आपके मीटर की घटना नाम से मेल खाता हुआ घटना प्रकार (केस-संवेदनशील)। उदाहरण: api.call, image.generated
string
ISO 8601 timestamp (UTC)। यदि इसे छोड़ा जाए, तो वर्तमान server time डिफ़ॉल्ट होता है। delayed/batch events के साथ सटीक billing के लिए इसे शामिल करें। 1 घंटे से पुराने या भविष्य में 5 मिनट से अधिक के timestamps अस्वीकार कर दिए जाते हैं।
object
संग्रहण और फ़िल्टरिंग के लिए अतिरिक्त गुण:
  • संख्यात्मक मान: bytes, tokens, duration_ms
  • फ़िल्टर: endpoint, method, quality

इवेंट भेजना

बेहतर प्रदर्शन के लिए प्रति अनुरोध अधिकतम 1,000 ईवेंट एकत्र करें। API प्रति कॉल 1,000 ईवेंट की एक सख्त सीमा लागू करता है।

इनजेशन ब्लूप्रिंट्स

सामान्य उपयोग मामलों के लिए तैयार किए गए इवेंट पैटर्न। खरोंच से बनाने के बजाय एक सिद्ध ब्लूप्रिंट से शुरू करें।

LLM Blueprint

OpenAI, Anthropic, Groq, Gemini और अन्य में AI टोकन उपयोग को ट्रैक करें।

API Gateway Blueprint

एंडपॉइंट फ़िल्टरिंग और दर सीमा समर्थन के साथ API अनुरोधों को मीटर करें।

Object Storage Blueprint

क्लाउड स्टोरेज सेवाओं के लिए फ़ाइल अपलोड और स्टोरेज खपत को ट्रैक करें।

Stream Blueprint

वीडियो, ऑडियो और रीयल-टाइम डेटा के लिए स्ट्रीमिंग बैंडविड्थ को मापें।

Time Range Blueprint

सर्वरलेस फ़ंक्शनों और कंप्यूट इंस्टेंस के लिए बीता समय के अनुसार बिल करें।

View All Blueprints

विस्तृत कार्यान्वयन मार्गदर्शिकाओं के साथ सभी उपलब्ध ब्लूप्रिंट देखें।

सर्वोत्तम प्रथाएँ

नक़ल से बचने के लिए निश्चित ID का उपयोग करें: ${customerId}_${action}_${timestamp}
5xx त्रुटियों पर घातीय बैकऑफ़ के साथ पुन: प्रयास करें। 4xx त्रुटियों पर पुन: प्रयास न करें।
रीयल-टाइम घटनाओं के लिए छोड़ दें। देरी/बैच घटनाओं के लिए सटीकता हेतु शामिल करें।
सफलता दरों को ट्रैक करें और पुन: प्रयास हेतु विफल घटनाओं को कतारबद्ध करें।

समस्या निवारण

  • घटना नाम को मीटर से बिल्कुल मेल करना चाहिए (केस-संवेदनशील)
  • ग्राहक ID मौजूद होना चाहिए
  • जांचें कि मीटर फ़िल्टर घटनाओं को बाहर नहीं कर रहे हैं
  • सुनिश्चित करें कि समय-छाप हाल ही के हैं
API कुंजी सही है और स्वरूप का उपयोग करें: Bearer YOUR_API_KEY
सुनिश्चित करें कि सभी आवश्यक फ़ील्ड मौजूद हैं: event_id, customer_id, event_name
  • मेटाडेटा कुंजी को मीटर के “ओवर प्रॉपर्टी” से बिल्कुल मिलना चाहिए
  • स्ट्रिंग नहीं, संख्याएँ उपयोग करें: tokens: 150 ना कि tokens: "150"

अगले कदम

Create Meters

फ़िल्टर और एग्रीगेशन फ़ंक्शन के साथ यह परिभाषित करें कि आपकी घटनाएँ बिल योग्य मात्राओं में कैसे एकत्रित होती हैं।

Ingestion Blueprints

LLM ट्रैकिंग, API गेटवे और स्टोरेज जैसे सामान्य उपयोग मामलों के लिए तैयार ब्लूप्रिंट का उपयोग करें।

Complete Tutorial

शुरू से उपयोग-आधारित बिलिंग के साथ पूर्ण AI इमेज जनरेटर बनाएं।

API Reference

सभी पैरामीटर, प्रतिक्रिया कोड और इंटरैक्टिव परीक्षण के साथ पूर्ण API दस्तावेज़।
अंतिम संशोधन 31 जुलाई 2026