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

API Reference — Events Ingestion

उदाहरणों और response codes सहित संपूर्ण API documentation।

इवेंट संरचना

string
आवश्यक
इवेंट के लिए एक unique identifier, जिसका उपयोग retry के दौरान duplicate events का पता लगाने के लिए किया जाता है। इसे action से derive करें, उदाहरण के लिए customer ID + action + timestamp, ताकि retry किया गया event वही ID बनाए रखे। हर retry पर नया random UUID बनाने से एक ही event दो बार count हो सकता है।
string
आवश्यक
Dodo Payments customer ID। यह किसी मान्य मौजूदा customer का होना चाहिए।
string
आवश्यक
वह event type जो आपके meter के event name से मेल खाता हो (case-sensitive)। उदाहरण: api.call, image.generated।
string
ISO 8601 timestamp (UTC)। यदि इसे छोड़ दिया जाए, तो वर्तमान server time डिफ़ॉल्ट रूप से उपयोग किया जाता है। विलंबित या batch events की accurate billing के लिए इसे शामिल करें। 1 घंटे से पुराने या भविष्य में 5 मिनट से अधिक समय वाले timestamps अस्वीकार कर दिए जाते हैं।
object
एग्रीगेशन और फ़िल्टरिंग के लिए अतिरिक्त प्रॉपर्टीज़। अधिकतम 50 कुंजियाँ; प्रत्येक कुंजी 100 वर्णों तक और प्रत्येक मान 500 वर्णों तक हो सकता है।
  • संख्यात्मक मान: bytes, tokens, duration_ms
  • फ़िल्टर: endpoint, method, quality

इवेंट भेजना

बेहतर performance के लिए प्रत्येक request में अधिकतम 1,000 events का batch भेजें। API प्रत्येक request में अधिकतम 1,000 events की hard limit लागू करती है।

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

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

LLM Blueprint

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

API Gateway Blueprint

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

Object Storage Blueprint

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

Stream Blueprint

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

Time Range Blueprint

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

View All Blueprints

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

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

duplicates को रोकने के लिए deterministic IDs का उपयोग करें: ${customerId}_${action}_${timestamp}।
5xx और 429 errors पर exponential backoff के साथ retry करें। अन्य 4xx errors पर retry न करें।
real-time events के लिए timestamps छोड़ दें। accurate billing के लिए delayed या batch events में इन्हें शामिल करें।
सफलता दरों को ट्रैक करें और पुन: प्रयास हेतु विफल घटनाओं को कतारबद्ध करें।

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

  • Event name का meter से बिल्कुल मेल खाना चाहिए (case-sensitive)
  • Customer ID आपके account में मौजूद होना चाहिए
  • जाँचें कि meter filters events को exclude तो नहीं कर रहे हैं
  • सत्यापित करें कि timestamps हाल के हैं
सत्यापित करें कि API key सही है और इस format का उपयोग करें: Bearer YOUR_API_KEY।
सुनिश्चित करें कि सभी required fields मौजूद हैं: event_id, customer_id, event_name।
  • Metadata keys meter के “Over Property” से बिल्कुल मेल खाने चाहिए
  • strings के बजाय numbers का उपयोग करें: tokens: 150, न कि tokens: "150"

अगले कदम

Create Meters

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

Ingestion Blueprints

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

Complete Tutorial

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

API Reference

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