שליחת קוד אימות (OTP) ב-SMS דרך API – תיעוד למפתחים

using System.Net.Http.Json;
using System.Security.Cryptography;

public sealed class Sms4FreeOtp(HttpClient http)
{
    public async Task<string> SendAsync(string phone, CancellationToken ct = default)
    {
        var code = RandomNumberGenerator.GetInt32(100000, 1000000).ToString();
        var res = await http.PostAsJsonAsync("https://api.sms4free.co.il/ApiSMS/v2/SendSMS", new {
            key = Environment.GetEnvironmentVariable("SMS4FREE_API_KEY"),
            user = Environment.GetEnvironmentVariable("SMS4FREE_USER"),
            pass = Environment.GetEnvironmentVariable("SMS4FREE_PASS"),
            sender = "MyApp", recipient = phone,
            msg = $"קוד האימות שלך ל-MyApp הוא {code}. תקף ל-5 דקות."
        }, ct);
        var data = await res.Content.ReadFromJsonAsync<Sms4FreeResponse>(ct);
        if (data is null || data.status <= 0) throw new InvalidOperationException($"SMS4FREE error {data?.status}: {data?.message}");
        return code;
    }
    public sealed record Sms4FreeResponse(int status, string message);
}

import crypto from "node:crypto";

export async function sendOtp(phone) {
  const code = crypto.randomInt(100000, 999999).toString();
  // שמרו code + phone + expiresAt (עכשיו + 5 דק׳) + attempts=0 במסד הנתונים שלכם

  const res = await fetch("https://api.sms4free.co.il/ApiSMS/v2/SendSMS", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      key: process.env.SMS4FREE_API_KEY,
      user: process.env.SMS4FREE_USER,
      pass: process.env.SMS4FREE_PASS,
      sender: "MyApp",
      recipient: phone,
      msg: `קוד האימות שלך ל-MyApp הוא ${code}. תקף ל-5 דקות.`,
    }),
    signal: AbortSignal.timeout(10_000),
  });
  const data = await res.json();
  if (!(data.status > 0)) throw new Error(`SMS4FREE error ${data.status}: ${data.message}`);
  return code;
}

import os, secrets, requests

def send_otp(phone: str) -> str:
    code = f"{secrets.randbelow(900000) + 100000}"
    r = requests.post(
        "https://api.sms4free.co.il/ApiSMS/v2/SendSMS",
        json={
            "key": os.environ["SMS4FREE_API_KEY"],
            "user": os.environ["SMS4FREE_USER"],
            "pass": os.environ["SMS4FREE_PASS"],
            "sender": "MyApp",
            "recipient": phone,
            "msg": f"קוד האימות שלך ל-MyApp הוא {code}. תקף ל-5 דקות.",
        },
        timeout=10,
    )
    data = r.json()
    if data.get("status", 0) <= 0:
        raise RuntimeError(f"SMS4FREE error {data.get('status')}: {data.get('message')}")
    return code

<?php
function sendOtp(string $phone): string {
    $code = (string) random_int(100000, 999999);
    $payload = json_encode([
        'key' => getenv('SMS4FREE_API_KEY'), 'user' => getenv('SMS4FREE_USER'), 'pass' => getenv('SMS4FREE_PASS'),
        'sender' => 'MyApp', 'recipient' => $phone,
        'msg' => "קוד האימות שלך ל-MyApp הוא $code. תקף ל-5 דקות.",
    ], JSON_UNESCAPED_UNICODE);
    $ch = curl_init('https://api.sms4free.co.il/ApiSMS/v2/SendSMS');
    curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_TIMEOUT => 10]);
    $data = json_decode(curl_exec($ch), true);
    if (($data['status'] ?? 0) <= 0) throw new RuntimeException("SMS4FREE error {$data['status']}: {$data['message']}");
    return $code;
}

curl -s https://api.sms4free.co.il/ApiSMS/v2/SendSMS \
  -H "Content-Type: application/json" \
  -d '{"key":"'"$SMS4FREE_API_KEY"'","user":"'"$SMS4FREE_USER"'","pass":"'"$SMS4FREE_PASS"'",
       "sender":"MyApp","recipient":"0541234567",
       "msg":"קוד האימות שלך ל-MyApp הוא 482913. תקף ל-5 דקות."}'

using System.Net.Http.Json;

public sealed class Sms4FreeBalance(HttpClient http)
{
    public async Task<int> AvailableAsync(CancellationToken ct = default)
    {
        var res = await http.PostAsJsonAsync("https://api.sms4free.co.il/ApiSMS/AvailableSMS", new {
            key = Environment.GetEnvironmentVariable("SMS4FREE_API_KEY"),
            user = Environment.GetEnvironmentVariable("SMS4FREE_USER"),
            pass = Environment.GetEnvironmentVariable("SMS4FREE_PASS"),
        }, ct);
        var text = await res.Content.ReadAsStringAsync(ct);
        var balance = int.Parse(text);
        if (balance < 0) throw new InvalidOperationException($"SMS4FREE error {balance}");
        return balance;
    }
}

export async function availableSms() {
  const res = await fetch("https://api.sms4free.co.il/ApiSMS/AvailableSMS", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      key: process.env.SMS4FREE_API_KEY,
      user: process.env.SMS4FREE_USER,
      pass: process.env.SMS4FREE_PASS,
    }),
    signal: AbortSignal.timeout(10_000),
  });
  const balance = Number(await res.text());
  if (balance < 0) throw new Error(`SMS4FREE error ${balance}`);
  return balance;
}

import os, requests

def available_sms() -> int:
    r = requests.post(
        "https://api.sms4free.co.il/ApiSMS/AvailableSMS",
        json={
            "key": os.environ["SMS4FREE_API_KEY"],
            "user": os.environ["SMS4FREE_USER"],
            "pass": os.environ["SMS4FREE_PASS"],
        },
        timeout=10,
    )
    balance = int(r.text)
    if balance < 0:
        raise RuntimeError(f"SMS4FREE error {balance}")
    return balance

<?php
function availableSms(): int {
    $payload = json_encode([
        'key' => getenv('SMS4FREE_API_KEY'),
        'user' => getenv('SMS4FREE_USER'),
        'pass' => getenv('SMS4FREE_PASS'),
    ]);
    $ch = curl_init('https://api.sms4free.co.il/ApiSMS/AvailableSMS');
    curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_TIMEOUT => 10]);
    $balance = (int) curl_exec($ch);
    if ($balance < 0) throw new RuntimeException("SMS4FREE error $balance");
    return $balance;
}

curl -s https://api.sms4free.co.il/ApiSMS/AvailableSMS \
  -H "Content-Type: application/json" \
  -d '{"key":"'"$SMS4FREE_API_KEY"'","user":"'"$SMS4FREE_USER"'","pass":"'"$SMS4FREE_PASS"'"}'