मुख्य सामग्री पर जाएं

Documentation Index

Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

​
अवलोकन

रियल-टाइम डिलीवरी

इवेंट तुरंत प्राप्त करें

पुश-आधारित

डेटा आपके सर्वर पर भेजा जाता है

कुशल

पोलिंग की ज़रूरत नहीं

विश्वसनीय

रीट्राई और रिकवरी का समर्थन

​
वेबहुक के प्रकार

प्रकारविवरण
फ़िल्टर्ड स्ट्रीम वेबहुक्सवेबहुक के ज़रिए फ़िल्टर्ड स्ट्रीम पोस्ट्स प्राप्त करें
Account Activity APIखाते की गतिविधि से जुड़ी इवेंट्स प्राप्त करें

​
वेबहुक कैसे काम करते हैं

┌──────────┐      ┌──────────┐      ┌──────────┐
│ X Event  │  →   │ X Server │  →   │ Your     │
│ Occurs   │      │          │      │ Webhook  │
└──────────┘      └──────────┘      └──────────┘
  1. इवेंट होता है — कोई उपयोगकर्ता पोस्ट करता है, DM भेजता है, आदि।
  2. X अनुरोध भेजता है — आपके वेबहुक URL पर POST अनुरोध भेजता है
  3. आप प्रोसेस करते हैं — आपका सर्वर इवेंट को हैंडल करता है
  4. 200 के साथ जवाब दें — पुष्टि के लिए 200 OK लौटाएँ

​
वेबहुक आवश्यकताएँ

आवश्यकताविवरण
HTTPSवेबहुक URL में HTTPS का उपयोग होना चाहिए
PublicURL सार्वजनिक रूप से सुलभ होना चाहिए
Fast response10 सेकंड के भीतर रिस्पॉन्स दें
200 OKपुष्टि के लिए 200 स्टेटस लौटाएँ

​
सुरक्षा

​
चैलेंज-रिस्पॉन्स चेक (CRC)

X आपके webhook को CRC अनुरोध भेजकर सत्यापित करता है। HMAC-SHA256 हैश के साथ उत्तर दें: 
import hmac
import hashlib
import base64

def handle_crc(crc_token, consumer_secret):
    sha256_hash = hmac.new(
        consumer_secret.encode(),
        crc_token.encode(),
        hashlib.sha256
    ).digest()
    
    return {
        "response_token": "sha256=" + base64.b64encode(sha256_hash).decode()
    }

​
हस्ताक्षर सत्यापन

x-twitter-webhooks-signature हेडर का उपयोग करके webhook की प्रामाणिकता की पुष्टि करें।

​
शुरुआत करना

पूर्वापेक्षाएँ

फ़िल्टर्ड स्ट्रीम वेबहुक्स

वेबहुक के ज़रिए फ़िल्टर की गई पोस्ट्स प्राप्त करें

Account Activity API

वेबहुक के ज़रिए खाते की गतिविधियों से जुड़े इवेंट प्राप्त करें