शुरू करें

त्वरित प्रारंभ: API द्वारा अपना पहला SMS भेजें

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

1. एक खाता बनाएं और बैलेंस टॉप अप करें

Get API key खोलें। आपका ब्राउज़र एक खाता कुंजी बनाता है जो acct_ से शुरू होती है; इसे कॉपी करें या फ़ाइल के रूप में सहेजें, फिर पुष्टि करें। वह कुंजी कंसोल में आपका लॉगिन है। बिलिंग पेज पर फंड जोड़ें: होस्टेड चेकआउट कंसोल में खुलता है, और बैलेंस हर कंसोल पेज के शीर्ष पर दिखाई देता है।

2. एक API कुंजी बनाएं

API कुंजी पेज पर, एक कुंजी का नाम दें (उदाहरण के लिए production या staging) और इसे बनाएं। कुंजी bsa_live_ से शुरू होती है और एक बार दिखाई जाती है: इसे अपने सीक्रेट स्टोर या एनवायरनमेंट वेरिएबल में कॉपी करें।

export BULKSMSAPI_KEY="bsa_live_..."

3. एक संदेश भेजें

अपने फोन पर एक टेक्स्ट भेजें। नंबर प्लस साइन के साथ अंतरराष्ट्रीय प्रारूप में लिखे जाते हैं।

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550123",
    "text": "Your Northwind code is 482913. It expires in 10 minutes.",
    "reference": "login-7781"
  }'

उत्तर 202 Accepted होता है जिसमें एक संदेश आईडी, कीमत और स्थिति queued होती है। कुछ सेकंड के भीतर स्थिति sent और फिर delivered में बदल जाती है।

4. स्थिति पढ़ें

curl https://bulksmsapi.cc/v1/messages/msg_8F3K2Q9TZ1MX \
  -H "Authorization: Bearer $BULKSMSAPI_KEY"

5. एक बैच भेजें

एक बैच एक टेक्स्ट को 10,000 नंबरों तक भेजता है। डुप्लिकेट और पढ़े न जा सकने वाले नंबर set_aside में सूचीबद्ध होते हैं और उन पर शुल्क नहीं लगता है।

curl https://bulksmsapi.cc/v1/batches \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: spring-sale-0412" \
  -d '{
    "name": "Spring sale",
    "text": "Spring sale at Northwind: 20% off until Sunday. Opt out: northwind.example/sms",
    "to": [
      "+14155550123",
      "+447400123456",
      "+4915123456789"
    ]
  }'

6. डिलीवरी इवेंट प्राप्त करें

Webhooks पेज पर, एक HTTPS एंडपॉइंट जोड़ें। प्रत्येक डिलीवर या फेल हुआ संदेश इसे साइन किए गए JSON इवेंट के साथ कॉल करता है; Webhooks पेज पर कोड के साथ सिग्नेचर की जांच करें और किसी भी 2xx स्थिति के साथ उत्तर दें।

अगला: प्रति नंबर व्यक्तिगत टेक्स्ट और शेड्यूलिंग के लिए Batches पढ़ें, और हर एरर कोड और आपके बैलेंस के लिए इसका क्या मतलब है, इसके लिए Errors पढ़ें।

त्वरित प्रारंभ: API द्वारा अपना पहला SMS भेजें | BulkSMSAPI दस्तावेज़