Preview Message API

POST Request (JSON Format)

curl -X POST "https://unify.smsgateway.center/SMSApi/preview" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "userid=YOUR_USERNAME" \
  -d "password=YOUR_PASSWORD" \
  -d "msg=Hello, this is a test message" \
  -d "senderid=YOUR_SENDER_ID" \
  -d "dltEntityId=YOUR_ENTITY_ID" \
  -d "format=json"

POST Request (XML Format)

curl -X POST "https://unify.smsgateway.center/SMSApi/preview" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "userid=YOUR_USERNAME" \
  -d "password=YOUR_PASSWORD" \
  -d "msg=Hello, this is a test message" \
  -d "senderid=YOUR_SENDER_ID" \
  -d "dltEntityId=YOUR_ENTITY_ID" \
  -d "format=xml"

POST Request (Plain Text Format)

curl -X POST "https://unify.smsgateway.center/SMSApi/preview" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "userid=YOUR_USERNAME" \
  -d "password=YOUR_PASSWORD" \
  -d "msg=Hello, this is a test message" \
  -d "senderid=YOUR_SENDER_ID" \
  -d "format=plain"

GET Request (Query Parameters)

curl -X GET "https://unify.smsgateway.center/SMSApi/preview?userid=YOUR_USERNAME&password=YOUR_PASSWORD&msg=Hello%2C%20this%20is%20a%20test%20message&senderid=YOUR_SENDER_ID&dltEntityId=YOUR_ENTITY_ID&format=json"

Using API Key (Alternative Authentication)

curl -X POST "https://unify.smsgateway.center/SMSApi/preview" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "apiKey: YOUR_API_KEY" \
  -d "userid=YOUR_USERNAME" \
  -d "msg=Hello, this is a test message" \
  -d "senderid=YOUR_SENDER_ID" \
  -d "format=json"

Without DLT Entity ID (Optional Parameter)

curl -X POST "https://unify.smsgateway.center/SMSApi/preview" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "userid=YOUR_USERNAME" \
  -d "password=YOUR_PASSWORD" \
  -d "msg=Hello, this is a test message" \
  -d "senderid=YOUR_SENDER_ID" \
  -d "format=json"

Example with Unicode Message

curl -X POST "https://unify.smsgateway.center/SMSApi/preview" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "userid=YOUR_USERNAME" \
  -d "password=YOUR_PASSWORD" \
  -d "msg=नमस्ते, यह एक परीक्षण संदेश है" \
  -d "senderid=YOUR_SENDER_ID" \
  -d "format=json"

{
  "status": "success",
  "statusCode": "200",
  "reason": "Preview generated successfully",
  "msgType": "text",
  "length": 28,
  "parts": 1,
  "dltTemplateId": "1234567890123456",
  "dltEntityId": "YOUR_ENTITY_ID",
  "amount": 0.05,
  "message": "Hello, this is a test message"
}

Note: Multi-part SMS messages are automatically concatenated by mobile operators and delivered as a single message to the recipient.

// React Native / JavaScript example
async function previewMessage(message, senderId, dltEntityId) {
  const params = new URLSearchParams({
    userid: 'YourUsername',
    password: 'YourPassword',
    output: 'json',
    msg: message,
    senderid: senderId,
    dltEntityId: dltEntityId || ''
  });

  try {
    const response = await fetch('https://unify.smsgateway.center/SMSApi/preview', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/x-www-form-urlencoded'
      },
      body: params.toString()
    });

    const data = await response.json();
    
    if (data.status === 'success' && data.statusCode === '200') {
      console.log('Message Preview:');
      console.log(`Type: ${data.msgType}`);
      console.log(`Length: ${data.length} characters`);
      console.log(`Parts: ${data.parts}`);
      console.log(`Cost: ${data.amount} per SMS`);
      
      if (data.dltTemplateId) {
        console.log(`DLT Template ID: ${data.dltTemplateId}`);
      }
      
      // Display preview in UI
      return {
        type: data.msgType,
        length: data.length,
        parts: data.parts,
        cost: data.amount,
        dltTemplateId: data.dltTemplateId
      };
    } else {
      console.error(`Preview failed: ${data.reason}`);
      return null;
    }
  } catch (error) {
    console.error('Preview error:', error);
    return null;
  }
}

// Usage in React Native component
const MessagePreview = ({ message, senderId }) => {
  const [preview, setPreview] = useState(null);
  
  useEffect(() => {
    if (message && message.length > 0) {
      previewMessage(message, senderId).then(setPreview);
    }
  }, [message, senderId]);
  
  if (!preview) return null;
  
  return (
    <View>
      <Text>Type: {preview.type}</Text>
      <Text>Length: {preview.length} characters</Text>
      <Text>Parts: {preview.parts}</Text>
      <Text>Cost: {preview.cost} per SMS</Text>
    </View>
  );
};

import requests
from urllib.parse import urlencode

def calculate_sms_cost(userid, password, message, sender_id, dlt_entity_id=None):
    url = 'https://unify.smsgateway.center/SMSApi/preview'
    
    data = {
        'userid': userid,
        'password': password,
        'format': 'json',
        'msg': message,
        'senderid': sender_id
    }
    
    if dlt_entity_id:
        data['dltEntityId'] = dlt_entity_id
    
    headers = {
        'Content-Type': 'application/x-www-form-urlencoded'
    }
    
    response = requests.post(url, data=data, headers=headers)
    result = response.json()
    
    if result['status'] == 'success':
        parts = result.get('parts', 1)
        amount_per_sms = float(result.get('amount', 0))
        total_cost = parts * amount_per_sms
        
        return {
            'message_type': result.get('msgType', 'text'),
            'length': result.get('length', 0),
            'parts': parts,
            'cost_per_sms': amount_per_sms,
            'total_cost': total_cost,
            'dlt_template_id': result.get('dltTemplateId')
        }
    else:
        raise Exception(f"Preview failed: {result.get('reason', 'Unknown error')}")

# Calculate cost for bulk sending
message = "Hello, this is a test message"
sender_id = "YOUR_SENDER_ID"
recipient_count = 1000

preview = calculate_sms_cost('YourUsername', 'YourPassword', message, sender_id)
total_cost = preview['total_cost'] * recipient_count

print(f"Message Type: {preview['message_type']}")
print(f"Length: {preview['length']} characters")
print(f"Parts: {preview['parts']}")
print(f"Cost per SMS: {preview['cost_per_sms']}")
print(f"Total cost for {recipient_count} recipients: {total_cost}")

<?php
function previewSMSMessage($userid, $password, $message, $senderId, $dltEntityId = null) {
    $url = 'https://unify.smsgateway.center/SMSApi/preview';
    
    $postData = array(
        'userid' => $userid,
        'password' => $password,
        'output' => 'json',
        'msg' => $message,
        'senderid' => $senderId
    );
    
    if ($dltEntityId !== null) {
        $postData['dltEntityId'] = $dltEntityId;
    }
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded'));
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($httpCode === 200) {
        $result = json_decode($response, true);
        
        if ($result['status'] === 'success') {
            return array(
                'success' => true,
                'msgType' => $result['msgType'],
                'length' => $result['length'],
                'parts' => $result['parts'],
                'amount' => $result['amount'],
                'dltTemplateId' => $result['dltTemplateId'] ?? null,
                'message' => $result['message']
            );
        } else {
            return array(
                'success' => false,
                'error' => $result['reason'] ?? 'Unknown error'
            );
        }
    } else {
        return array(
            'success' => false,
            'error' => 'HTTP Error: ' . $httpCode
        );
    }
}

// Usage
$preview = previewSMSMessage(
    'YourUsername',
    'YourPassword',
    'Hello, this is a test message',
    'YOUR_SENDER_ID',
    'YOUR_ENTITY_ID' // Optional
);

if ($preview['success']) {
    echo "Message Type: " . $preview['msgType'] . "\n";
    echo "Length: " . $preview['length'] . " characters\n";
    echo "Parts: " . $preview['parts'] . "\n";
    echo "Cost: " . $preview['amount'] . " per SMS\n";
    
    if ($preview['dltTemplateId']) {
        echo "DLT Template ID: " . $preview['dltTemplateId'] . "\n";
    }
} else {
    echo "Error: " . $preview['error'] . "\n";
}