Introducción

Descom SMS te ofrece una API para integrar en tus propios desarrollos los envío de SMS a traves de nuestra plataformas. Está es la nueva versión de la API, si necesitas funcionalidades que aún no están integradas en está, puede acceder a la documentación de la versión anterior en el siguiente enlace.

Novedad La nueva API soporta el juego de caracteres UTF-8, ahora puedes enviar acentos y el resto de caracteres que antes no podias.

Características de la API


  • Todas las llamadas a la API se realizan mediante peticiones HTTP
  • HTTPS: Transmisión encriptada de datos obligatoria
  • Autentificación: Sistema de autentificación mediante usuario/contraseña
  • JSON: Los datos usan el standard JSON

Uso


Todas las llamadas a la API tienen la siguiente base url: https://api.descomsms.com/api usando los métodos GET o POST dependiendo de la llamada

Cada petición a la API debe incorporar la cabecera de nombre Content-Type con el valor: application/json vea el siguiente ejemplo

    curl https://api.descomsms.com/api \
    -H "Content-Type: application/json"

Respuestas


Cada petición a la API devolverá un código de respuesta HTTP. Estos son los estados que te podrás encontrar:

  • 200 La petición se ha efectuado correctamente
  • 401 Autentificación requerida o denegada
  • 402 Saldo insuficiente para realizar el envío
  • 403 No tiene permisos para acceder a este elemento
  • 422 Los datos enviados no son validos
  • 503 Error interno, la petición no ha sido efectuada