इवेंट इनजेशन

अपने एप्लिकेशन से उपयोग इवेंट भेजें ताकि ग्राहक की खपत को ट्रैक किया जा सके और बिलिंग को शक्ति दी जा सके।

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

API Reference - Events Ingestion

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

​

इवेंट संरचना

Required Fields

event_id · string · आवश्यक

विशिष्ट पहचानकर्ता। UUID का उपयोग करें या ग्राहक ID + टाइमस्टैम्प + क्रिया को मिलाएं।

customer_id · string · आवश्यक

Dodo Payments ग्राहक ID। यह एक वैध मौजूदा ग्राहक होना चाहिए।

event_name · string · आवश्यक

आपके मीटर की घटना नाम से मेल खाता हुआ घटना प्रकार (केस-संवेदनशील)। उदाहरण: api.call, image.generated

Optional Fields

timestamp · string

ISO 8601 समय-छाप। यदि छोड़ा गया तो डिफ़ॉल्ट सर्वर समय। देरी/बैच घटनाओं के लिए सटीक बिलिंग हेतु शामिल करें।

metadata · object

संग्रहण और फ़िल्टरिंग के लिए अतिरिक्त गुण:

• संख्यात्मक मान: bytes, tokens, duration_ms
• फ़िल्टर: endpoint, method, quality

metadata: {
  endpoint: "/v1/orders",
  method: "POST",
  tokens: 1024
}

​

इवेंट भेजना

Single Event

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: "api_call_1234",
      customer_id: "cus_abc123",
      event_name: "api.call",
      metadata: { endpoint: "/v1/orders" }
    }]
  })
});

बेहतर प्रदर्शन के लिए प्रति अनुरोध 100 घटनाओं तक का बैच।

​

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

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

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

नक़ल से बचने के लिए निश्चित ID का उपयोग करें: ${customerId}_${action}_${timestamp}

Implement Retries

5xx त्रुटियों पर घातीय बैकऑफ़ के साथ पुन: प्रयास करें। 4xx त्रुटियों पर पुन: प्रयास न करें।

Include Timestamps

रीयल-टाइम घटनाओं के लिए छोड़ दें। देरी/बैच घटनाओं के लिए सटीकता हेतु शामिल करें।

Monitor Delivery

सफलता दरों को ट्रैक करें और पुन: प्रयास हेतु विफल घटनाओं को कतारबद्ध करें।

​

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

Events not appearing

• घटना नाम को मीटर से बिल्कुल मेल करना चाहिए (केस-संवेदनशील)
• ग्राहक ID मौजूद होना चाहिए
• जांचें कि मीटर फ़िल्टर घटनाओं को बाहर नहीं कर रहे हैं
• सुनिश्चित करें कि समय-छाप हाल ही के हैं

Authentication errors (401)

API कुंजी सही है और स्वरूप का उपयोग करें: Bearer YOUR_API_KEY

Validation errors (400)

सुनिश्चित करें कि सभी आवश्यक फ़ील्ड मौजूद हैं: event_id, customer_id, event_name

Metadata not aggregating

• मेटाडेटा कुंजी को मीटर के “ओवर प्रॉपर्टी” से बिल्कुल मिलना चाहिए
• स्ट्रिंग नहीं, संख्याएँ उपयोग करें: tokens: 150 ना कि tokens: "150"

​

अगले कदम

Create Meters

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

Ingestion Blueprints

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

Complete Tutorial

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

API Reference

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