ZENOR BD SMS API Documentation

# 1. JSON POST Request (Recommended for production applications)
curl -X POST https://smsapi.zenorbd.com/smsapiv3 \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "senderid": "YOUR_APPROVED_SENDER_ID",
    "type": "text",
    "scheduledDateTime": "",
    "msg": "Your order #1084 has been confirmed.",
    "contacts": "01XXXXXXXXX"
  }'

# 2. HTTP GET Request (Quick testing / Webhooks)
curl -X GET "https://smsapi.zenorbd.com/smsapiv3?apikey=YOUR_API_KEY&sender=YOUR_APPROVED_SENDER_ID&msisdn=01XXXXXXXXX&smstext=Your+verification+code+is+582104"

import os
import requests

def send_sms(api_key, sender_id, recipient, message):
    url = "https://smsapi.zenorbd.com/smsapiv3"
    
    payload = {
        "api_key": api_key,
        "senderid": sender_id,
        "type": "text",
        "scheduledDateTime": "",
        "msg": message,
        "contacts": recipient
    }
    
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json"
    }
    
    try:
        response = requests.post(url, json=payload, headers=headers, timeout=15)
        response.raise_for_status()
        data = response.json()
        
        # Verify status code 0 (Accepted)
        if data.get("response") and data["response"][0].get("status") == 0:
            return {"success": True, "message_id": data["response"][0].get("id"), "data": data}
        return {"success": False, "error": "Gateway rejected", "data": data}
        
    except requests.exceptions.RequestException as e:
        return {"success": False, "error": str(e)}

if __name__ == "__main__":
    API_KEY = os.getenv("ZENOR_SMS_API_KEY", "YOUR_API_KEY")
    result = send_sms(API_KEY, "YOUR_APPROVED_SENDER_ID", "01XXXXXXXXX", "Test notification from Python.")
    print(result)

async function sendSMS({ apiKey, senderId, recipient, message }) {
  const url = 'https://smsapi.zenorbd.com/smsapiv3';

  const payload = {
    api_key: apiKey,
    senderid: senderId,
    type: 'text',
    scheduledDateTime: '',
    msg: message,
    contacts: recipient,
  };

  try {
    const response = await fetch(url, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json',
      },
      body: JSON.stringify(payload),
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    const result = data?.response?.[0];

    if (result && result.status === 0) {
      return { success: true, messageId: result.id, raw: data };
    }

    return { success: false, error: 'Gateway returned error status', raw: data };
  } catch (error) {
    return { success: false, error: error.message };
  }
}

// Example usage
const API_KEY = process.env.ZENOR_SMS_API_KEY || 'YOUR_API_KEY';
sendSMS({
  apiKey: API_KEY,
  senderId: 'YOUR_APPROVED_SENDER_ID',
  recipient: '01XXXXXXXXX',
  message: 'Your verification OTP is 829103.',
}).then(console.log);