# मैसेजिंग API v2 का अवलोकन

मैसेजिंग API v2, Pushwoosh द्वारा समर्थित हर चैनल पर आउटबाउंड संदेश बनाने के लिए एक एकल REST/JSON एंडपॉइंट है:

- पुश: iOS, Android, Huawei, Baidu, macOS, Amazon, Windows, Safari, Chrome, Firefox, IE
- ईमेल
- SMS
- Telegram, Kakao, LINE, WhatsApp, Viber

**चैनल** पेलोड प्रकार (`payload` पुश / SMS / मैसेंजर के लिए, `email_payload` ईमेल के लिए) द्वारा चुना जाता है।

**लक्ष्यीकरण** अनुरोध के प्रकार (`segment` ऑडियंस सेगमेंट के लिए, `transactional` स्पष्ट डिवाइस या उपयोगकर्ता सूचियों के लिए) द्वारा चुना जाता है।

## बेस URL

```
https://api.pushwoosh.com
```

यदि आप एक समर्पित क्षेत्र या निजी परिनियोजन का उपयोग करते हैं, तो अपने Pushwoosh ग्राहक सफलता प्रबंधक से सटीक बेस URL की पुष्टि करें।

## प्रमाणीकरण

प्रत्येक अनुरोध में सर्वर-साइड Pushwoosh [API एक्सेस टोकन](/hi/developer/api-reference/api-access-token/#server-api-token) के साथ एक `Authorization` हेडर शामिल होना चाहिए:

```
Authorization: Token YOUR_API_TOKEN
```

उसी टोकन का उपयोग करें जिसे आप पहले से ही सर्वर-टू-सर्वर API कॉल के लिए जारी करते हैं। इस टोकन को क्लाइंट एप्लिकेशन में उजागर न करें।

## मेथड्स

- [`Notify`](/hi/developer/api-reference/messaging-api-v2/notify/): `POST /messaging/v2/notify`। एक एकल संदेश (सेगमेंट या ट्रांजैक्शनल) बनाएं और भेजें।
- [`Cancel`](/hi/developer/api-reference/messaging-api-v2/cancel/): `POST /messaging/v2/cancel`। पहले बनाए गए संदेश को रद्द करें जो अभी तक डिलीवर नहीं हुआ है।
- [`Update`](/hi/developer/api-reference/messaging-api-v2/update/): `POST /messaging/v2/update`। अभी भी शेड्यूल किए गए संदेश को एक नई परिभाषा से बदलें।

## अनुरोध और प्रतिक्रिया प्रारूप

- कंटेंट प्रकार: `application/json`।
- फ़ील्ड नाम `snake_case` का उपयोग करते हैं। `oneof` समूह नेस्टेड ऑब्जेक्ट के रूप में दिखाई देते हैं जिनमें ठीक एक कुंजी सेट होती है।
- Enum मानों को उनके स्ट्रिंग नामों के रूप में क्रमबद्ध किया जाता है (उदाहरण के लिए, `"IOS"`, `"MESSAGE_TYPE_MARKETING"`)।
- सफल प्रतिक्रियाएं JSON बॉडी के साथ HTTP 200 लौटाती हैं; त्रुटियां मानक gRPC-गेटवे त्रुटि लिफाफे का उपयोग करती हैं — `{ "code": ..., "message": ..., "details": [...] }`।

## त्वरित शुरुआत

```bash title="एक सेगमेंट को पुश भेजें"
curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "code": "active_users",
      "payload": {
        "content": {
          "localized_content": {
            "en": {
              "ios":     { "body": "Hello from v2!" },
              "android": { "body": "Hello from v2!" }
            }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" },
      "message_type": "MESSAGE_TYPE_MARKETING"
    }
  }'
```

## SMTP पर ईमेल भेजना

यदि कोई सेवा पहले से ही SMTP का उपयोग करती है, तो आप सीधे `Notify` को कॉल करने के बजाय [SMTP गेटवे](/hi/developer/api-reference/smtp-gateway/) के माध्यम से ट्रांजैक्शनल ईमेल सबमिट कर सकते हैं। गेटवे प्रत्येक संदेश को इस API को एक ट्रांजैक्शनल `Notify` के रूप में अग्रेषित करता है, इसलिए वही प्रमाणीकरण और ईमेल पेलोड नियम लागू होते हैं।

## अगले चरण

<CardGrid>
  <LinkCard title="Notify" href="/developer/api-reference/messaging-api-v2/notify/" />
  <LinkCard title="Cancel" href="/developer/api-reference/messaging-api-v2/cancel/" />
  <LinkCard title="Update" href="/developer/api-reference/messaging-api-v2/update/" />
  <LinkCard title="पेलोड संदर्भ" href="/developer/api-reference/messaging-api-v2/payload-reference/" />
  <LinkCard title="ईमेल पेलोड संदर्भ" href="/developer/api-reference/messaging-api-v2/email-payload-reference/" />
  <LinkCard title="SMTP गेटवे" href="/developer/api-reference/smtp-gateway/" />
  <LinkCard title="v1 से माइग्रेशन" href="/developer/api-reference/messaging-api-v2/migration-from-v1/" />
</CardGrid>