Validate DLT Template API

curl --location 'https://unify.smsgateway.center/SMSApi/validateTemplate' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'userid=YourUsername' \
--data-urlencode 'password=YourPassword' \
--data-urlencode 'output=json' \
--data-urlencode 'senderid=SMSGAT' \
--data-urlencode 'msg=Your Instant Demo account is live. This is a Demo Test message. {#var#} Demo Message SMSGatewayCenter' \
--data-urlencode 'dltTemplateId=xxxx16194317445xxxx'

<?php

$curl = curl_init();

$postData = array(
  'userid' => 'YourUsername',
  'password' => 'YourPassword',
  'output' => 'json',
  'senderid' => 'SMSGAT',
  'msg' => 'Your Instant Demo account is live. This is a Demo Test message. {#var#} Demo Message SMSGatewayCenter',
  'dltTemplateId' => 'xxxx16194317445xxxx'
);

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://unify.smsgateway.center/SMSApi/validateTemplate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => http_build_query($postData),
  CURLOPT_HTTPHEADER => array(
    "Content-Type: application/x-www-form-urlencoded",
    "cache-control: no-cache"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "status": "success",
  "template": "Your Instant Demo account is live  This is a Demo Test message  {#var#} Demo Message SMSGatewayCenter",
  "dltTemplateId": "xxxx16194317445xxxx",
  "senderId": "SMSGAT",
  "statusCode": "200",
  "reason": "success",
  "text": "Your Instant Demo account is live. This is a Demo Test message. {#var#} Demo Message SMSGatewayCenter"
}

Explanation: The message matches the DLT template successfully. Note that punctuation differences are normalized (periods may be converted to spaces in the template field).

{
  "status": "error",
  "statusCode": "188",
  "reason": "message template mismatch"
}

Explanation: The message does not match the registered DLT template. Check for differences in text, spacing, or variable syntax.

Correct Variable Format: {#var#}

Examples of valid variables:

• {#var#} - Generic variable placeholder

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

  try {
    const response = await fetch('https://unify.smsgateway.center/SMSApi/validateTemplate', {
      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('✓ Template validated successfully');
      console.log(`Sender: ${data.senderId}`);
      console.log(`Template: ${data.template}`);
      
      // Proceed to send SMS
      return true;
    } else {
      console.error(`✗ Validation failed: ${data.reason}`);
      alert(`Template mismatch. Please check your message format.`);
      
      // Do not send SMS
      return false;
    }
  } catch (error) {
    console.error('Validation error:', error);
    return false;
  }
}

// Usage
const isValid = await validateBeforeSend(
  'SMSGAT',
  'Your Instant Demo account is live. This is a Demo Test message. {#var#} Demo Message SMSGatewayCenter',
  'xxxx16194317445xxxx'
);

if (isValid) {
  // Send SMS using send API
  sendSMS(...);
}

import requests
from urllib.parse import urlencode

def validate_template(userid, password, sender_id, message, dlt_template_id):
    url = 'https://unify.smsgateway.center/SMSApi/validateTemplate'
    
    data = {
        'userid': userid,
        'password': password,
        'output': 'json',
        'senderid': sender_id,
        'msg': message,
        'dltTemplateId': dlt_template_id
    }
    
    headers = {
        'Content-Type': 'application/x-www-form-urlencoded'
    }
    
    response = requests.post(url, data=data, headers=headers)
    result = response.json()
    
    return result['status'] == 'success' and result['statusCode'] == '200'

# Batch validate multiple messages
messages_to_validate = [
    {
        'sender': 'SMSGAT',
        'message': 'Your OTP is {#var#}. Valid for 10 minutes.',
        'template_id': '1234567890123456'
    },
    {
        'sender': 'SMSGAT',
        'message': 'Your order {#var#} is confirmed. Amount: Rs {#var#}',
        'template_id': '9876543210987654'
    }
]

valid_messages = []
invalid_messages = []

for msg in messages_to_validate:
    is_valid = validate_template(
        'YourUsername',
        'YourPassword',
        msg['sender'],
        msg['message'],
        msg['template_id']
    )
    
    if is_valid:
        valid_messages.append(msg)
        print(f"✓ Valid: {msg['message'][:50]}...")
    else:
        invalid_messages.append(msg)
        print(f"✗ Invalid: {msg['message'][:50]}...")

print(f"\n{len(valid_messages)} valid, {len(invalid_messages)} invalid")

<?php
function validateAndPreviewMessage($senderId, $template, $dltTemplateId, $variables) {
    // Replace variables in template for preview
    $previewMessage = $template;
    $varIndex = 1;
    
    foreach ($variables as $value) {
        $previewMessage = preg_replace('/{#var#}/', $value, $previewMessage, 1);
    }
    
    // Validate template first
    $url = "https://unify.smsgateway.center/SMSApi/validateTemplate";
    
    $postData = array(
        'userid' => 'YourUsername',
        'password' => 'YourPassword',
        'output' => 'json',
        'senderid' => $senderId,
        'msg' => $template,
        'dltTemplateId' => $dltTemplateId
    );
    
    $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);
    curl_close($ch);
    
    $result = json_decode($response, true);
    
    if ($result['status'] === 'success') {
        echo "✓ Template is valid!\n";
        echo "Template: " . $result['template'] . "\n";
        echo "Preview: " . $previewMessage . "\n";
        return true;
    } else {
        echo "✗ Validation failed: " . $result['reason'] . "\n";
        return false;
    }
}

// Usage
$template = "Your OTP is {#var#}. Valid for {#var#} minutes. Do not share.";
$variables = ['123456', '10'];
$dltTemplateId = '1234567890123456';

validateAndPreviewMessage('SMSGAT', $template, $dltTemplateId, $variables);
// Output Preview: Your OTP is 123456. Valid for 10 minutes. Do not share.