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