NAV
shell

Introducción

¡Bienvenidos a la API de Servicios Tribológicos! Los clientes de Servicios Tribológicos pueden tener acceso a esta API para obtener información sobre sus activos, muestras, resultados o cualquier consulta particular.

Autenticación

Para autenticarse use la siguiente cabecera:

curl "https://api.stng.cl/v1/..." \
  -H "ApiKey: XXXXXXX"

Asegúrese de reemplazar XXXXXXX con su llave.

La API de Servicios Tribológicos hace uso de una llave (token) que el cliente deberá incluir a la cabecera de la consulta para autenticarse. Cada cliente puede tener una única llave.

La adquisición y renovación de esta llave podrá hacerse a través de la plataforma app.stng.cl (aún no implementado) o contactando directamente a Servicios Tribológicos.

Resultados

Resultados por fecha

curl 'https://api.stng.cl/v1/results/by/date?from=2019-12-8T10:00&to=2019-12-9' \
  -X GET \
  -H "ApiKey: XXXXXXX"  \
  -H "Accept: application/json"

Un ejemplo de respuesta exitosa para la consulta de arriba:

{
  "data": [
    {
      "correlative": 479321,
      "date_sampling": "2019-12-08T00:00:00",
      "date_entry": "2019-12-08T15:12:54",
      "date_receive": "2019-12-08T15:33:29",
      "date_withdraw": "2019-12-08T11:30:00",
      "date_essay": "2019-12-09T18:17:31",
      "component": "COMPONENTE_X",
      "machine": "CAMIÓN_Y",
      "site": "FAENA_Z",
      "results": [
        { "value": "22.48", "essay_id": 1, "essay_name": "Fierro" },
        { "value": "0.28", "essay_id": 2, "essay_name": "Cromo" },
        { "value": "0.00", "essay_id": 3, "essay_name": "Aluminio" },
        { "value": "0.50", "essay_id": 4, "essay_name": "Cobre" },
        { "value": "0.05", "essay_id": 5, "essay_name": "Plomo" },
        { "value": "0.00", "essay_id": 6, "essay_name": "Nickel" },
        { "value": "0.00", "essay_id": 11, "essay_name": "Cadmio" },
        { "value": "0.00", "essay_id": 12, "essay_name": "Manganeso" },
        { "value": "3.21", "essay_id": 13, "essay_name": "Sodio" },
        { "value": "0.53", "essay_id": 14, "essay_name": "Potasio" },
        { "value": "10.26", "essay_id": 15, "essay_name": "Silicio" },
        { "value": "1415", "essay_id": 16, "essay_name": "Zinc" },
        { "value": "0.00", "essay_id": 17, "essay_name": "Bario" },
        { "value": "302.66", "essay_id": 18, "essay_name": "Boro" },
        { "value": "2242", "essay_id": 19, "essay_name": "Calcio" },
        { "value": "35.79", "essay_id": 20, "essay_name": "Molibdeno" },
        { "value": "22.89", "essay_id": 21, "essay_name": "Magnesio" },
        { "value": "1212", "essay_id": 22, "essay_name": "Fósforo" },
        { "value": "0.0", "essay_id": 26, "essay_name": "Contenido de agua" },
        { "value": "25", "essay_id": 29, "essay_name": "Índice PQ" },
        {
          "value": "0.0",
          "essay_id": 30,
          "essay_name": "Dilución por combustible"
        },
        { "value": "0.176", "essay_id": 31, "essay_name": "Oxidación" },
        { "value": "0.197", "essay_id": 32, "essay_name": "Sulfatación" },
        { "value": "0.082", "essay_id": 33, "essay_name": "Nitración" },
        { "value": "1.11", "essay_id": 55, "essay_name": "Hollín %" }
      ]
    }
  ]
}

Devuelve los resultados de los ensayos de laboratorio disponibles filtrados por fecha de informes.

Consulta HTTP

GET https://api.stng.cl/v1/results/by/date

Parámetros de la consulta

Parámetro Tipo Requerido Por defecto Descripción
from String ✓ Fecha de inicio
to String ✓ Fecha de término
id_machine_type Int ID tipo de equipo
id_machine Int ID equipo
id_component_type Int ID tipo de componente
id_component Int ID componente
tag String TAG componente

Errores

Respuesta para una consulta no exitosa:

{ error: "Mensaje describiendo el error" }

La API de STNG utiliza los siguientes códigos de error:

Código Descripción
400 Bad Request -- La consulta es inválida.
401 Unauthorized -- Llave inválida o no provista.
403 Forbidden -- No está autorizado para acceder a ese contenido.
404 Not Found -- No se encontró el endpoint.
500 Internal Server Error -- Problema interno del servidor.
shell