OTP SMS API Documentation for Developers

<?php

namespace App\Services;

use Illuminate\Support\Facades\Http;

class OtpService
{
    public function sendOtp(string $phone, string $otp): bool
    {
        $response = Http::withToken(config('services.nizorasms.api_key'))
            ->post('https://nizorasms.com/api/v1/otp/send', [
                'phone' => $phone,
                'otp' => $otp,
                'template_id' => 'TPL_LOGIN_VERIFY',
            ]);

        return $response->successful() && $response->json('status') === 'success';
    }
}

const axios = require('axios');

async function dispatchOtp(phone, otpCode) {
  try {
    const response = await axios.post(
      'https://nizorasms.com/api/v1/otp/send',
      {
        phone: phone,
        otp: otpCode,
        template_id: 'TPL_LOGIN_VERIFY'
      },
      {
        headers: {
          'Authorization': `Bearer ${process.env.NIZORA_API_KEY}`,
          'Content-Type': 'application/json'
        },
        timeout: 5000
      }
    );

    return response.data;
  } catch (error) {
    console.error('NizoraSMS Error:', error.response?.data || error.message);
    throw error;
  }
}

module.exports = { dispatchOtp };

import requests

def send_otp(phone: str, otp_code: str) -> dict:
    url = "https://nizorasms.com/api/v1/otp/send"
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "phone": phone,
        "otp": otp_code,
        "template_id": "TPL_LOGIN_VERIFY"
    }
    
    response = requests.post(url, json=payload, headers=headers, timeout=5)
    response.raise_for_status()
    return response.json()

# Example usage
# res = send_otp("919876543210", "591024")
# print("Job:", res.get("job_id"))

import 'dart:convert';
import 'package:http/http.dart' as http;

// Your own authenticated backend proxies SMS requests and stores the secret API key.
class NizoraSmsService {
  static const String _backend = 'https://YOUR_APP_DOMAIN/api/send-otp';

  static Future<bool> requestOtp(String phone) async {
    final response = await http.post(
      Uri.parse(_backend),
      headers: {'Content-Type': 'application/json'},
      body: jsonEncode({'phone': phone}),
    );
    return response.statusCode == 200;
  }
}

// Protect this endpoint with authentication, rate limiting and anti-abuse checks.
// Do not put NizoraSMS API credentials or raw OTP verification logic in client code.

import okhttp3.*;
import java.io.IOException;

public class NizoraClient {
    private static final OkHttpClient client = new OkHttpClient();

    public static void sendOtp(String phone, String otp) throws IOException {
        MediaType JSON = MediaType.get("application/json; charset=utf-8");
        String json = "{\"phone\":\"" + phone + "\",\"otp\":\"" + otp + "\",\"template_id\":\"TPL_LOGIN_VERIFY\"}";

        RequestBody body = RequestBody.create(json, JSON);
        Request request = new Request.Builder()
                .url("https://nizorasms.com/api/v1/otp/send")
                .header("Authorization", "Bearer YOUR_API_KEY")
                .post(body)
                .build();

        try (Response response = client.newCall(request).execute()) {
            System.out.println("Response: " + response.body().string());
        }
    }
}

curl -X POST https://nizorasms.com/api/v1/otp/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "919876543210",
    "otp": "839120",
    "template_id": "TPL_LOGIN_VERIFY"
  }'