Send SMS From Python, Node.js and PHP Without Twilio (Copy-Paste Code)

export SMSPORTAL_API_KEY="paste_your_key_here"

curl -X POST "https://smsportal.app/api/v1/gateway/send-sms" \
  -H "x-api-key: $SMSPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipients": ["+14155550101"], "message": "Test from my terminal"}'

import os
import time
import requests

API = "https://smsportal.app/api/v1"
HEADERS = {"x-api-key": os.environ["SMSPORTAL_API_KEY"]}


def send_sms(recipients, message, scheduled_at=None, retries=3):
    payload = {"recipients": recipients, "message": message}
    if scheduled_at:
        payload["scheduledAt"] = scheduled_at  # ISO 8601, in the future

    for attempt in range(retries):
        try:
            res = requests.post(
                f"{API}/gateway/send-sms",
                headers=HEADERS, json=payload, timeout=15,
            )
        except requests.RequestException:
            time.sleep(2 ** attempt)           # network error: retry
            continue

        if res.status_code == 200:
            return res.json()["data"]["smsBatchId"]
        if res.status_code >= 500:
            time.sleep(2 ** attempt)           # server error: retry
            continue
        # 400, 401, 429: retrying will not change the result
        raise RuntimeError(f"HTTP {res.status_code}: {res.text}")

    raise RuntimeError("SMS not sent after several attempts")


batch_id = send_sms(["+14155550101"], "Your car is ready for pickup. Smith Auto.")
print(batch_id)

const API = 'https://smsportal.app/api/v1'
const headers = {
  'x-api-key': process.env.SMSPORTAL_API_KEY,
  'Content-Type': 'application/json',
}
const sleep = (ms) => new Promise((r) => setTimeout(r, ms))

export async function sendSms(recipients, message, scheduledAt, retries = 3) {
  const payload = { recipients, message, ...(scheduledAt && { scheduledAt }) }

  for (let attempt = 0; attempt < retries; attempt++) {
    let res
    try {
      res = await fetch(`${API}/gateway/send-sms`, {
        method: 'POST',
        headers,
        body: JSON.stringify(payload),
        signal: AbortSignal.timeout(15000),
      })
    } catch {
      await sleep(2 ** attempt * 1000) // network error: retry
      continue
    }

    if (res.ok) return (await res.json()).data.smsBatchId
    if (res.status >= 500) {
      await sleep(2 ** attempt * 1000) // server error: retry
      continue
    }
    // 400, 401, 429: retrying will not change the result
    throw new Error(`HTTP ${res.status}: ${await res.text()}`)
  }
  throw new Error('SMS not sent after several attempts')
}

console.log(await sendSms(['+14155550101'], 'Order 1042 has shipped.'))

<?php
const SMSPORTAL_API = 'https://smsportal.app/api/v1';

function sendSms(array $recipients, string $message, ?string $scheduledAt = null): string
{
    $payload = ['recipients' => $recipients, 'message' => $message];
    if ($scheduledAt !== null) {
        $payload['scheduledAt'] = $scheduledAt; // ISO 8601, in the future
    }

    $ch = curl_init(SMSPORTAL_API . '/gateway/send-sms');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 15,
        CURLOPT_HTTPHEADER => [
            'x-api-key: ' . getenv('SMSPORTAL_API_KEY'),
            'Content-Type: application/json',
        ],
        CURLOPT_POSTFIELDS => json_encode($payload),
    ]);

    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);

    if ($body === false) {
        throw new RuntimeException("Network error: $error");
    }
    if ($status !== 200) {
        throw new RuntimeException("HTTP $status: $body", $status);
    }

    return json_decode($body, true)['data']['smsBatchId'];
}

echo sendSms(['+14155550101'], 'Your appointment is tomorrow at 10:00.');

res = requests.get(
    f"{API}/gateway/messages",
    headers=HEADERS,
    params={"smsBatchId": batch_id},
    timeout=15,
)
for m in res.json()["data"]:
    print(m["recipient"], m["status"])

const url = new URL(`${API}/gateway/messages`)
url.searchParams.set('smsBatchId', batchId)

const res = await fetch(url, { headers: { 'x-api-key': process.env.SMSPORTAL_API_KEY } })
const { data } = await res.json()
data.forEach((m) => console.log(m.recipient, m.status))

const res = await fetch('https://smsportal.app/api/v1/gateway/send-bulk-sms', {
  method: 'POST',
  headers,
  body: JSON.stringify({
    messages: [
      { recipients: ['+14155550101'], message: 'Anna, your visit is tomorrow at 10:00.' },
      { recipients: ['+16475550187'], message: 'Peter, your visit is tomorrow at 11:30.' },
    ],
  }),
})