Inicio rápido

Introducción

Eveses ofrece números de teléfono bajo demanda para verificaciones por SMS. Pides un número, recibes el código de un solo uso y pagas solo cuando el SMS llega realmente.

Esta página te lleva por tu primera solicitud end-to-end en tres pasos.

1. Crea una clave API

Inicia sesión y abre Account → API Keys. Pulsa New key, dale un nombre (por ejemplo local-dev) y copia el valor que muestra el diálogo. El token solo se muestra una vez — guárdalo de inmediato en tu gestor de contraseñas o en un archivo .env.

export EVESES_API_KEY="17|aBcDeFgHiJ…"

2. Pide un número

Elige un país (ISO-2) y un slug de servicio (telegram, whatsapp, discord, any, …) y haz POST a /v1/activations:

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "ua", "service": "telegram", "duration_minutes": 5}'

La respuesta contiene el número y un id de activación con el que recogerás el código:

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"waiting","price_cents":50,"expires_at":"2026-05-26T14:35:00Z"}

3. Lee el código del SMS

Introduce el número en el formulario de verificación del servicio y sondea la activación hasta que llegue el SMS:

curl https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer $EVESES_API_KEY"

Cuando llegue el SMS, la respuesta incluirá un array sms con el OTP. La mayoría de proveedores entrega en 30 segundos. Si no llega nada antes del vencimiento, no se cobra.

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"sms_received","price_cents":50,"expires_at":"2026-05-26T14:35:00Z","sms":[{"code":"123456","text":"Your code: 123456","received_at":"2026-05-26T14:30:14Z"}]}

Siguientes pasos

• Deja de sondear, usa webhooks — suscríbete a activation.sms_received y te enviamos el OTP. Mira la sección Webhooks.
• Usa un SDK — las bibliotecas oficiales para PHP, JavaScript, Python y Go están en SDKs.
• Lee sobre idempotencia — envuelve la creación en un Idempotency-Key para que los reintentos no duplican el cargo.