वेबहुक्स

वेबहुक डिलीवरी के ज़रिए रीयल-टाइम डेटा प्राप्त करें

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 का उपयोग होना चाहिए
Public	URL सार्वजनिक रूप से सुलभ होना चाहिए
Fast response	10 सेकंड के भीतर रिस्पॉन्स दें
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 की प्रामाणिकता की पुष्टि करें।

---

​

शुरुआत करना

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

• एक स्वीकृत डेवलपर खाता
• डेवलपर कंसोल में एक Project और ऐप
• सार्वजनिक रूप से सुलभ HTTPS एंडपॉइंट

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

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

Account Activity API

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