Configuración de mensajes

AutenticaciónCopiar enlace

ParámetrosCopiar enlace

Sin parámetros de ruta o consulta. No requiere cuerpo.

Cómo usar este métodoCopiar enlace

Comprueba qué tipos de mensaje permite la combinación de country, service y operator. Envía la cabecera apikey; no se necesitan parámetros de ruta ni de consulta. La respuesta incluye todas las reglas ordenadas por ID ascendente, aunque no muestra los IDs.

Cada condición no vacía debe coincidir; una cadena vacía acepta cualquier valor. Tiene prioridad la regla coincidente con más condiciones no vacías. Por ejemplo, una regla de país y servicio sustituye a una regla solo de país; añadir el operador la hace aún más específica. Usa juntos los tres indicadores de esa regla: sms, caller y voice emplean 1 para permitido y 0 para desactivado.

Si ninguna regla coincide, se permiten los tres tipos. Un array data vacío es una respuesta correcta sin reglas configuradas. Estos permisos no garantizan números disponibles.

El parámetro de consulta voice tiene otro significado al consultar precios o pedir números: 0 SMS, 1 identificación de llamada, 2 voz. Usa el mismo tipo al comparar precios y al pedir el número. Comprueba la disponibilidad por separado.

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/countryservicesettings" \
  --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": [
    {
      "country": "",
      "service": "opt20",
      "operator": "",
      "voice": 0,
      "caller": 0,
      "sms": 1
    },
    {
      "country": "FR",
      "service": "opt20",
      "operator": "",
      "voice": 1,
      "caller": 0,
      "sms": 1
    }
  ]
}

{
  "statusCode": 200,
  "data": []
}

{
  "statusCode": 400,
  "error": {
    "type": "APIKEY_NOT_SET",
    "description": "No ApiKey found"
  }
}

{
  "statusCode": 401,
  "error": {
    "type": "USER_NOT_FOUND",
    "description": "Not found"
  }
}

{
  "statusCode": 402,
  "error": {
    "type": "RATELIMIT_EXCEED",
    "description": "Request ratelimit exeeded"
  }
}

{
  "statusCode": 403,
  "error": {
    "type": "USER_BANNED",
    "description": "User banned"
  }
}

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

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.