SMS Nitro

Verificación por SMS en PHP

Un script completo en PHP 8 con la extensión cURL: compra un número temporal, espera el código y cierra el pedido.

¿Cómo recibo un código de verificación por SMS en PHP?

Haz peticiones cURL con la cabecera X-Api-Key: POST /v1/orders con cuerpo JSON para obtener el número, consulta GET /v1/orders/{id} cada 4 segundos hasta que messages traiga el SMS y llama a POST finish. Cancela si no llega nada para liberar el importe reservado.

Preparación

  • PHP 8.0 o superior con las extensiones curl y json.
  • Define la clave en el entorno: SMSNITRO_API_KEY=...

Script completo

activation.php
<?php
// PHP 8+ with the cURL extension. Run: SMSNITRO_API_KEY=... php activation.php
const API = 'https://smsnitro.com/api/v1';

function api(string $method, string $path, ?array $body = null): array {
    $ch = curl_init(API . $path);
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST  => $method,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 30,
        CURLOPT_HTTPHEADER     => [
            'X-Api-Key: ' . getenv('SMSNITRO_API_KEY'),
            'Content-Type: application/json',
        ],
    ]);
    if ($body !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    }
    $data = json_decode(curl_exec($ch), true);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    curl_close($ch);
    if ($status >= 400) {
        throw new RuntimeException("$status: " . ($data['detail'] ?? 'error'));
    }
    return $data;
}

echo 'Balance: ', api('GET', '/balance')['balance'], " USD\n";

$order = api('POST', '/orders', ['product' => 'telegram', 'country' => 'usa']);
echo "Number: {$order['phone']} (order {$order['id']})\n";

$deadline = time() + 600; // numbers stay reserved for up to 20 minutes
while (time() < $deadline) {
    $order = api('GET', "/orders/{$order['id']}");
    if ($order['messages']) {
        echo 'Code: ', end($order['messages'])['code'], "\n";
        api('POST', "/orders/{$order['id']}/finish");
        exit(0);
    }
    if (in_array($order['status'], ['CANCELED', 'TIMEOUT', 'BANNED', 'FINISHED'], true)) {
        exit("Ended without SMS: {$order['status']} (not charged)\n");
    }
    sleep(4); // poll every 3 to 5 seconds
}
api('POST', "/orders/{$order['id']}/cancel"); // refund the frozen amount
echo "No SMS: cancelled and refunded\n";

Uso en una aplicación web

  • Ejecuta el bucle de consulta en una cola de tareas o en un comando de consola, no dentro de una petición web.
  • Guarda el id del pedido; tu front-end consulta el estado a tu servidor.
  • Mantén la clave en el entorno del servidor, nunca en plantillas ni en JavaScript.

Páginas relacionadas

Recibe tu código de verificación ahora

Recarga desde 5 USD, elige la app y el país y lee el SMS en tu navegador. Se cobra solo cuando llega el código.

Obtener un número