SMSPVAdevelopers
Activation V2
SMSPVA / API REFERENCE

Bloquear número

Marca como no operativo el número asociado a un pedido.

SMSPVA API
PUThttps://api.smspva.com/activation/blocknumber/{orderid}

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ón

NombreUbicaciónTipoObligatorioDescripción
apikeyheaderstringSíTu clave API

Parámetros

NombreUbicaciónTipoObligatorioDescripción
orderidpathintegerSíID del pedido

No requiere cuerpo de solicitud.

Cómo usar este método

Marca como no operativo el número de este orderid.

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_ORDER_ID: orderid (obligatorio).
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_ORDER_ID:?Set SMSPVA_ORDER_ID to your orderid}"
curl --fail-with-body --max-time 30 --request PUT \
  --url "https://api.smspva.com/activation/blocknumber/${SMSPVA_ORDER_ID}" \
  --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ó.
411Acceso limitado por karma bajo o exceso de solicitudes.
501El servidor no pudo procesar la solicitud.
503El servidor está sobrecargado. Inténtalo más tarde.
HTTP 200

Operación completada

Respuesta ilustrativa

{
  "statusCode": 200,
  "data": {
    "orderId": 123456
  }
}

Campos de respuesta

NombreTipoDescripción
statusCodeintegerCódigo de estado del resultado
dataobjectDatos de respuesta
data.orderIdintegerID del pedido
HTTP 405

Formato de número no válido

Respuesta ilustrativa

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

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
errorobjectDatos de respuesta
error.typestringTipo de error
error.descriptionstringDescripción del error
HTTP 411

Acceso limitado por karma bajo o exceso de solicitudes.

Respuesta ilustrativa

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

Campos de respuesta

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

El servidor no pudo procesar la solicitud.

Respuesta ilustrativa

{
  "statusCode": 501,
  "error": {
    "type": "SERVER_FAIL",
    "description": "Server failed to process request"
  }
}

Campos de respuesta

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

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

Respuesta ilustrativa

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

Campos de respuesta

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

Guías relacionadas

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

En esta página