SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

Estado del número

Comprueba un número utilizado anteriormente para el mismo servicio.

SMSPVA API
GEThttps://api.smspva.com/activation/numberstatus/{number}/{service}

Autenticación

NombreUbicaciónTipoObligatorioDescripción
apikeyheaderstringSíTu clave API

Parámetros

NombreUbicaciónTipoObligatorioDescripción
numberpathstringSíNúmero sin prefijo telefónico del país. (pattern: "^[0-9]{5,}$")
servicepathstringSíCódigo de servicio. Consulta los códigos en servicesprices.

No requiere cuerpo de solicitud.

Cómo usar este método

Comprueba si un número que ya has usado puede seguir recibiendo SMS del mismo service. La consulta solo sirve si antes recibiste SMS de ese servicio en ese número. Envía number sin el prefijo telefónico del país.

Ejemplos de solicitud

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_NUMBER: number (obligatorio).
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_NUMBER:?Set SMSPVA_NUMBER to your number}"
curl --fail-with-body --max-time 30 --request GET \
  --url "https://api.smspva.com/activation/numberstatus/${SMSPVA_NUMBER}/opt0" \
  --header "apikey: $SMSPVA_API_KEY"

Respuestas

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.

HTTPDescripción
200Operación completada
405Formato de número no válido
406El ID del pedido no es válido o no se encontró.
500Error interno. La descripción puede incluir información de diagnóstico.
501El servidor no pudo procesar la solicitud.
502No se encontró el número.
503El servidor está sobrecargado. Inténtalo más tarde.
504av2.resp.504.desc: la fuente no incluye una descripción desarrollada para esta respuesta.
HTTP 200

Operación completada

Respuesta ilustrativa

{
  "statusCode": 200,
  "data": {
    "number": "98765432",
    "orderId": 123456,
    "countryCode": "+7"
  }
}

Campos de respuesta

NombreTipoDescripción
statusCodeintegerCódigo de estado del resultado
dataobjectDatos de respuesta
data.numberstringNúmero sin prefijo telefónico del país.
data.orderIdintegerID de tu pedido anterior para ese número y servicio.
data.countryCodestringPrefijo telefónico del país.
HTTP 405

Formato de número no válido

Respuesta ilustrativa

{
  "statusCode": 405,
  "error": {
    "type": "INVALID_NUMBER_FORMAT",
    "description": "Number should be integer with more than 5 digits"
  }
}

Campos de respuesta

NombreTipoDescripción
statusCodeintegerCódigo de estado del resultado
errorobjectDatos de respuesta
error.typestringTipo de error
error.descriptionstringDescripción del error
HTTP 406

El ID del pedido no es válido o no se encontró.

Respuesta ilustrativa

{
  "statusCode": 406,
  "error": {
    "type": "ORDER_NOT_FOUND",
    "description": "Order not found."
  }
}

Campos de respuesta

NombreTipoDescripción
statusCodeintegerCódigo de estado del resultado
errorobjectDetalles del error
error.typestringTipo de error
error.descriptionstringDescripción del error
HTTP 500

Error interno. La descripción puede incluir información de diagnóstico.

Respuesta ilustrativa

{
  "statusCode": 500,
  "error": {
    "type": "SERVER_ERROR",
    "description": "An internal error has occurred while processing your request."
  }
}

Campos de respuesta

NombreTipoDescripción
statusCodeinteger
errorobject
error.typestring
error.descriptionstring
HTTP 501

El servidor no pudo procesar la solicitud.

HTTP 502

No se encontró el número.

HTTP 503

El servidor está sobrecargado. Inténtalo más tarde.

HTTP 504

av2.resp.504.desc: la fuente no incluye una descripción desarrollada para esta respuesta.

Guías relacionadas

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

En esta página