Inicio

API DOA: D3-DOA (servicios del cubo de datos)

Generales de la API
  • Todas las respuestas retornan un código 200 en caso de ser exitoso, de lo contrario se retorna un código 400 en caso de error de formatos o conexión con base de datos y un 401 en caso de acceso denegado.
  • El formato para enviar y recibir datos es JSON, a excepción de las llamadas GET que se les pasa parámetros por la URL.
  • La URL raíz de todos los endpoints es: https://srt.snet.gob.sv/apidoa/api
  • Todos los métodos están protegidos por una capa de autenticación para lo cual se deberá proporcionar un token que se puede generar, utilizando un username y password, en endpoint POST /Authentication/request.
  • Utilizar el usuario y clave:
    Username: [email protected]
    Password: AP1_DOA_cl@v3
  • Si se omiten campos cuando se agregan nuevos elementos, estos campos se registrarán como nulos. Esto en el caso que el campo permita nulos.
Obtener token

Funcionalidad
URL
Tipo
Parámetros
Retorna
Comentarios
Obtiene token
/Autenticacion/request-token
POST
Objeto Json
Objeto Json
---

Ejemplo de objeto JSON de parámetro para obtener token:
{
Username: [email protected],
Password: AP1_DOA_cl@v3
}

Figura 1. Ejemplo de utilización de request-token

Funcionalidad
URL
Tipo
Parámetros
Retorna
Comentarios
Obtiene las áreas de interés
api/D3/ca/aois
GET
---
Arreglo Json
---
Obtiene los registros estadísticos de temperatura
api/D3/ca/temperaturas
POST
Objeto JSON con fecha1, fecha2 y id_aoi
Arreglo Json
Fecha1 es la fecha desde y fecha2 es hasta