API Reference - Events Ingestion
उदाहरणों और प्रतिक्रिया कोड के साथ पूर्ण API दस्तावेज़।
इवेंट संरचना
Required Fields
Required Fields
विशिष्ट पहचानकर्ता। UUID का उपयोग करें या ग्राहक ID + टाइमस्टैम्प + क्रिया को मिलाएं।
Dodo Payments ग्राहक ID। यह एक वैध मौजूदा ग्राहक होना चाहिए।
आपके मीटर की घटना नाम से मेल खाता हुआ घटना प्रकार (केस-संवेदनशील)। उदाहरण:
api.call, image.generatedOptional Fields
Optional Fields
इवेंट भेजना
इनजेशन ब्लूप्रिंट्स
सामान्य उपयोग मामलों के लिए तैयार किए गए इवेंट पैटर्न। खरोंच से बनाने के बजाय एक सिद्ध ब्लूप्रिंट से शुरू करें।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
नक़ल से बचने के लिए निश्चित ID का उपयोग करें:
${customerId}_${action}_${timestamp}Implement Retries
Implement Retries
5xx त्रुटियों पर घातीय बैकऑफ़ के साथ पुन: प्रयास करें। 4xx त्रुटियों पर पुन: प्रयास न करें।
Include Timestamps
Include Timestamps
रीयल-टाइम घटनाओं के लिए छोड़ दें। देरी/बैच घटनाओं के लिए सटीकता हेतु शामिल करें।
Monitor Delivery
Monitor Delivery
सफलता दरों को ट्रैक करें और पुन: प्रयास हेतु विफल घटनाओं को कतारबद्ध करें।
समस्या निवारण
Events not appearing
Events not appearing
- घटना नाम को मीटर से बिल्कुल मेल करना चाहिए (केस-संवेदनशील)
- ग्राहक ID मौजूद होना चाहिए
- जांचें कि मीटर फ़िल्टर घटनाओं को बाहर नहीं कर रहे हैं
- सुनिश्चित करें कि समय-छाप हाल ही के हैं
Authentication errors (401)
Authentication errors (401)
API कुंजी सही है और स्वरूप का उपयोग करें:
Bearer YOUR_API_KEYValidation errors (400)
Validation errors (400)
सुनिश्चित करें कि सभी आवश्यक फ़ील्ड मौजूद हैं:
event_id, customer_id, event_nameMetadata not aggregating
Metadata not aggregating
- मेटाडेटा कुंजी को मीटर के “ओवर प्रॉपर्टी” से बिल्कुल मिलना चाहिए
- स्ट्रिंग नहीं, संख्याएँ उपयोग करें:
tokens: 150ना किtokens: "150"
अगले कदम
Create Meters
फ़िल्टर और एग्रीगेशन फ़ंक्शन के साथ यह परिभाषित करें कि आपकी घटनाएँ बिल योग्य मात्राओं में कैसे एकत्रित होती हैं।
Ingestion Blueprints
LLM ट्रैकिंग, API गेटवे और स्टोरेज जैसे सामान्य उपयोग मामलों के लिए तैयार ब्लूप्रिंट का उपयोग करें।
Complete Tutorial
शुरू से उपयोग-आधारित बिलिंग के साथ पूर्ण AI इमेज जनरेटर बनाएं।
API Reference
सभी पैरामीटर, प्रतिक्रिया कोड और इंटरैक्टिव परीक्षण के साथ पूर्ण API दस्तावेज़।