Obtener número

Esta solicitud puede modificar un pedido o generar cargos. Los ejemplos no la repiten automáticamente. Leer un SMS recién recibido puede generar el cobro, aunque el método use GET.

AutenticaciónCopiar enlace

ParámetrosCopiar enlace

No requiere cuerpo de solicitud.

Cómo usar este métodoCopiar enlace

Solicita un número para el country y el service elegidos.

Elige códigos en las listas. Antes de solicitar el número, consulta precios, disponibilidad y tipos de mensaje permitidos. También puedes comparar operadores y países.

Guarda data.orderId para Recibir SMS y gestionar el pedido. Calcula su vencimiento con data.orderExpireIn. Si la solicitud agota el tiempo de espera, revisa Pedidos actuales antes de pedir otro número: el primero puede haberse creado.

Ejemplos de solicitudCopiar enlace

Requisitos y configuración del entorno. cURL usa un shell POSIX. El ejemplo JavaScript también es válido en TypeScript sobre Node.js. Java utiliza el cliente estándar y muestra JSON sin analizar; usa la biblioteca JSON de tu aplicación.

: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --fail-with-body --max-time 30 --request GET \
  --url "https://api.smspva.com/activation/number/BD/opt20?voice=0" \
  --header "apikey: $SMSPVA_API_KEY"

RespuestasCopiar enlace

Los ejemplos muestran el formato de respuesta. Los precios, las cantidades y los datos de cuenta son orientativos; consulta la API para obtener valores actuales.

{
  "statusCode": 200,
  "data": {
    "orderId": 123456,
    "phoneNumber": 9876544321,
    "countryCode": "BD",
    "orderExpireIn": 600
  }
}

{
  "statusCode": 405,
  "error": {
    "type": "INVALID_PARAMS",
    "description": "Invalid params."
  }
}

{
  "statusCode": 407,
  "error": {
    "type": "LOW_BALANCE",
    "description": "Low balance."
  }
}

{
  "statusCode": 411,
  "error": {
    "type": "ACCESS_LIMITED",
    "description": "Access is temporary limited."
  }
}

{
  "statusCode": 500,
  "error": {
    "type": "NUMBER_FETCH_FAIL",
    "description": "Failed to fetch number"
  }
}

{
  "statusCode": 501,
  "error": {
    "type": "PRICE_FETCH_FAIL",
    "description": "Failed to fetch price"
  }
}

{
  "statusCode": 502,
  "error": {
    "type": "NUMBER_NOT_FOUND",
    "description": "Number not found."
  }
}

{
  "statusCode": 503,
  "error": {
    "type": "SERVER_BUSY",
    "description": "Server overload, try later."
  }
}

Guías relacionadasCopiar enlace

• Activation V2
• Datos de referencia
• Flujo de activación
• Errores y límites
• Descargar OpenAPI

Si falla la conexión al modificar un pedido, comprueba su estado antes de repetir.