Sigue funcionando y tus API Keys valen igual para la REST, pero ya no se amplía. Para pasar, cambia cada método por su ruta y la firma por la nueva: la tabla de equivalencias está en Migrar desde /APIv3/. En Logs API verás marcadas como «API antigua» las peticiones que aún le llegan.
<?php
// Enviar un SMS con la API REST de MundoSMS (PHP 7.4 o superior, con la extensión curl)
$token = "eyJ..."; // el Token de tu API Key
$private_key = "aaaaaaaaaaaa"; // su clave privada; "" si la API Key no exige firma
$api = "https://api.mundosms.es/v3/";
$respuesta = mundosms("POST", "sms", [
"to" => "34600123456",
"text" => "Hola, esto es una prueba",
"from" => "MundoSMS.es",
], $token, $private_key, $api);
if (($respuesta["status"] ?? "") === "success") echo "Enviado\n";
else echo "Error " . ($respuesta["status_code"] ?? "") . ": " . ($respuesta["message"] ?? "") . "\n";
print_r($respuesta);
// Llama a una ruta de la API (sin «/v3/»: "sms", "calls"…) y devuelve SIEMPRE un array: la respuesta de la API o, si no se
// pudo conectar, ["status" => "error", "message" => "..."]. En GET y DELETE los datos van en la query; en POST y PATCH, en
// el cuerpo JSON. $private_key vacía: la petición va sin firma.
function mundosms($metodo, $ruta, $datos, $token, $private_key, $api) {
$query = ""; $cuerpo = "";
if ($metodo === "GET" || $metodo === "DELETE") { if ($datos) $query = "?" . http_build_query($datos, "", "&", PHP_QUERY_RFC3986); }
elseif ($datos) $cuerpo = json_encode($datos, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
$ts = (string) time();
$cabeceras = ["Authorization: Bearer " . $token, "X-Timestamp: " . $ts];
if ($private_key !== "") {
// X-Signature = base64url( HMAC-SHA256( clave privada, token.ts.MÉTODO /v3/ruta?query.cuerpo ) ), sin "=" al final
$firmado = $token . "." . $ts . "." . $metodo . " /v3/" . $ruta . $query . "." . $cuerpo;
$cabeceras[] = "X-Signature: " . rtrim(strtr(base64_encode(hash_hmac("sha256", $firmado, $private_key, true)), "+/", "-_"), "=");
}
if ($cuerpo !== "") $cabeceras[] = "Content-Type: application/json";
$ch = curl_init($api . $ruta . $query);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $metodo,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $cabeceras,
CURLOPT_TIMEOUT => 60,
]);
if ($cuerpo !== "") curl_setopt($ch, CURLOPT_POSTFIELDS, $cuerpo); // exactamente el JSON firmado
$respuesta = curl_exec($ch);
if ($respuesta === false) return ["status" => "error", "message" => "No se pudo conectar: " . curl_error($ch)];
$r = json_decode($respuesta, true);
return is_array($r) ? $r : ["status" => "error", "message" => "Respuesta inesperada: " . substr($respuesta, 0, 200)];
}
# Enviar un SMS con la API REST de MundoSMS (Python 3.8 o superior, sin librerías externas)
import base64, hashlib, hmac, json, time, urllib.error, urllib.parse, urllib.request
TOKEN = "eyJ..." # el Token de tu API Key
PRIVATE_KEY = "aaaaaaaaaaaa" # su clave privada; "" si la API Key no exige firma
API = "https://api.mundosms.es/v3/"
def mundosms(metodo, ruta, datos=None):
"""Llama a una ruta de la API (sin «/v3/»: "sms", "calls"…) y devuelve SIEMPRE un dict: la respuesta o {"status": "error", ...}.
En GET y DELETE los datos van en la query; en POST y PATCH, en el cuerpo JSON."""
datos = datos or {}
query, cuerpo = "", b""
if metodo in ("GET", "DELETE"):
if datos:
query = "?" + urllib.parse.urlencode(datos, quote_via=urllib.parse.quote)
elif datos:
cuerpo = json.dumps(datos, ensure_ascii=False, separators=(",", ":")).encode() # se firma y se envía EXACTAMENTE esto
ts = str(int(time.time()))
cabeceras = {"Authorization": "Bearer " + TOKEN, "X-Timestamp": ts}
if PRIVATE_KEY:
firmado = (TOKEN + "." + ts + "." + metodo + " /v3/" + ruta + query + ".").encode() + cuerpo
cabeceras["X-Signature"] = base64.urlsafe_b64encode(hmac.new(PRIVATE_KEY.encode(), firmado, hashlib.sha256).digest()).decode().rstrip("=")
if cuerpo:
cabeceras["Content-Type"] = "application/json"
peticion = urllib.request.Request(API + ruta + query, data=cuerpo or None, headers=cabeceras, method=metodo)
try:
with urllib.request.urlopen(peticion, timeout=60) as r:
texto = r.read()
except urllib.error.HTTPError as e: # 4xx y 5xx también traen JSON
texto = e.read()
except urllib.error.URLError as e:
return {"status": "error", "message": "No se pudo conectar: " + str(e.reason)}
try:
return json.loads(texto)
except ValueError:
return {"status": "error", "message": "Respuesta inesperada: " + texto[:200].decode(errors="replace")}
respuesta = mundosms("POST", "sms", {"to": "34600123456", "text": "Hola, esto es una prueba", "from": "MundoSMS.es"})
if respuesta.get("status") == "success":
print("Enviado")
else:
print("Error", respuesta.get("status_code", ""), respuesta.get("message", ""))
print(respuesta)
// Enviar un SMS con la API REST de MundoSMS (Node.js 18 o superior, sin dependencias)
const crypto = require("crypto");
const TOKEN = "eyJ..."; // el Token de tu API Key
const PRIVATE_KEY = "aaaaaaaaaaaa"; // su clave privada; "" si la API Key no exige firma
const API = "https://api.mundosms.es/v3/";
// Llama a una ruta de la API (sin «/v3/»: "sms", "calls"…) y devuelve SIEMPRE un objeto: la respuesta o { status: "error", message }.
// En GET y DELETE los datos van en la query; en POST y PATCH, en el cuerpo JSON.
async function mundosms(metodo, ruta, datos = {}) {
let query = "", cuerpo = "";
if (metodo === "GET" || metodo === "DELETE") {
const q = new URLSearchParams(datos).toString();
if (q) query = "?" + q;
} else if (Object.keys(datos).length) {
cuerpo = JSON.stringify(datos); // se firma y se envía EXACTAMENTE esto
}
const ts = String(Math.floor(Date.now() / 1000));
const cabeceras = { "Authorization": "Bearer " + TOKEN, "X-Timestamp": ts };
if (PRIVATE_KEY) {
cabeceras["X-Signature"] = crypto.createHmac("sha256", PRIVATE_KEY)
.update(TOKEN + "." + ts + "." + metodo + " /v3/" + ruta + query + "." + cuerpo).digest("base64url");
}
if (cuerpo) cabeceras["Content-Type"] = "application/json";
try {
const r = await fetch(API + ruta + query, { method: metodo, headers: cabeceras, body: cuerpo || undefined, signal: AbortSignal.timeout(60000) });
const texto = await r.text();
try { return JSON.parse(texto); } catch (e) { return { status: "error", message: "Respuesta inesperada: " + texto.slice(0, 200) }; }
} catch (e) {
return { status: "error", message: "No se pudo conectar: " + e.message };
}
}
mundosms("POST", "sms", { to: "34600123456", text: "Hola, esto es una prueba", from: "MundoSMS.es" }).then((respuesta) => {
if (respuesta.status === "success") console.log("Enviado");
else console.log("Error", respuesta.status_code || "", respuesta.message || "");
console.log(respuesta);
});
#!/bin/bash
# Enviar un SMS con la API REST de MundoSMS (bash, curl y openssl)
TOKEN="eyJ..." # el Token de tu API Key
PRIVATE_KEY="aaaaaaaaaaaa" # su clave privada; "" si la API Key no exige firma
API="https://api.mundosms.es/v3/"
# mundosms MÉTODO RUTA [JSON]: llama a una ruta de la API (sin «/v3/»; en GET y DELETE, con la query ya puesta) y escribe la
# respuesta. Firma con $PRIVATE_KEY si no está vacía: X-Signature = base64url( HMAC-SHA256( clave privada,
# token.ts.MÉTODO /v3/ruta?query.cuerpo ) ), sin "=" al final
mundosms() {
local metodo="$1" ruta="$2" cuerpo="${3:-}" ts firma=() datos=()
ts=$(date +%s)
if [ -n "$PRIVATE_KEY" ]; then
firma=(-H "X-Signature: $(printf '%s' "$TOKEN.$ts.$metodo /v3/$ruta.$cuerpo" | openssl dgst -sha256 -hmac "$PRIVATE_KEY" -binary | base64 | tr '+/' '-_' | tr -d '=\n')")
fi
[ -n "$cuerpo" ] && datos=(-H "Content-Type: application/json" --data-raw "$cuerpo")
curl -sS -X "$metodo" "$API$ruta" -H "Authorization: Bearer $TOKEN" -H "X-Timestamp: $ts" "${firma[@]}" "${datos[@]}"
echo
}
mundosms POST sms '{"to":"34600123456","text":"Hola, esto es una prueba","from":"MundoSMS.es"}'