API Reference — Events Ingestion
उदाहरणों और response codes सहित संपूर्ण API documentation।
इवेंट संरचना
Required Fields
Required Fields
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।Optional Fields
Optional Fields
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
इवेंट भेजना
इनजेशन ब्लूप्रिंट्स
सामान्य उपयोग मामलों के लिए तैयार किए गए इवेंट पैटर्न। खरोंच से बनाने के बजाय एक सिद्ध ब्लूप्रिंट से शुरू करें।LLM Blueprint
OpenAI, Anthropic, Groq, Gemini और अन्य में AI टोकन उपयोग को ट्रैक करें।
API Gateway Blueprint
एंडपॉइंट फ़िल्टरिंग और दर सीमा समर्थन के साथ API अनुरोधों को मीटर करें।
Object Storage Blueprint
क्लाउड स्टोरेज सेवाओं के लिए फ़ाइल अपलोड और स्टोरेज खपत को ट्रैक करें।
Stream Blueprint
वीडियो, ऑडियो और रीयल-टाइम डेटा के लिए स्ट्रीमिंग बैंडविड्थ को मापें।
Time Range Blueprint
सर्वरलेस फ़ंक्शनों और कंप्यूट इंस्टेंस के लिए बीता समय के अनुसार बिल करें।
View All Blueprints
विस्तृत कार्यान्वयन मार्गदर्शिकाओं के साथ सभी उपलब्ध ब्लूप्रिंट देखें।
सर्वोत्तम प्रथाएँ
Use Unique Event IDs
Use Unique Event IDs
duplicates को रोकने के लिए deterministic IDs का उपयोग करें:
${customerId}_${action}_${timestamp}।Implement Retries
Implement Retries
5xx और
429 errors पर exponential backoff के साथ retry करें। अन्य 4xx errors पर retry न करें।Include Timestamps
Include Timestamps
real-time events के लिए timestamps छोड़ दें। accurate billing के लिए delayed या batch events में इन्हें शामिल करें।
Monitor Delivery
Monitor Delivery
सफलता दरों को ट्रैक करें और पुन: प्रयास हेतु विफल घटनाओं को कतारबद्ध करें।
समस्या निवारण
Events not appearing
Events not appearing
- Event name का meter से बिल्कुल मेल खाना चाहिए (case-sensitive)
- Customer ID आपके account में मौजूद होना चाहिए
- जाँचें कि meter filters events को exclude तो नहीं कर रहे हैं
- सत्यापित करें कि timestamps हाल के हैं
Authentication errors (401)
Authentication errors (401)
सत्यापित करें कि API key सही है और इस format का उपयोग करें:
Bearer YOUR_API_KEY।Validation errors (400)
Validation errors (400)
सुनिश्चित करें कि सभी required fields मौजूद हैं:
event_id, customer_id, event_name।Metadata not aggregating
Metadata not aggregating
- Metadata keys meter के “Over Property” से बिल्कुल मेल खाने चाहिए
- strings के बजाय numbers का उपयोग करें:
tokens: 150, न किtokens: "150"
अगले कदम
Create Meters
फ़िल्टर और एग्रीगेशन फ़ंक्शन के साथ यह परिभाषित करें कि आपकी घटनाएँ बिल योग्य मात्राओं में कैसे एकत्रित होती हैं।
Ingestion Blueprints
LLM ट्रैकिंग, API गेटवे और स्टोरेज जैसे सामान्य उपयोग मामलों के लिए तैयार ब्लूप्रिंट का उपयोग करें।
Complete Tutorial
शुरू से उपयोग-आधारित बिलिंग के साथ पूर्ण AI इमेज जनरेटर बनाएं।
API Reference
सभी पैरामीटर, प्रतिक्रिया कोड और इंटरैक्टिव परीक्षण के साथ पूर्ण API दस्तावेज़।