API Portas — Datos · Playground

Probar lecturas y altas/actualizaciones en vivo · Ver documentación →

En producción: los endpoints de datos están operativos. Cargá tu API key (con scopes datos:read / datos:write) y probá en vivo. Las escrituras impactan la base real de FreeWayNet.

1. Configuración

⚠ La key se guarda solo en sessionStorage de este navegador.

2. Operación

Completá uno de los dos. Si la respuesta trae posición o trayectoria, se dibuja el mapa más abajo. GET /v1/contenedores/{nro}/eta o GET /v1/legajos/{id}/eta.
GET /v1/contenedores/eta — requiere scope admin:read. Trae todos los contenedores con su cliente e interno. Con detalle=1 la respuesta puede pesar varios MB (dibuja la ruta de todos).

Alta de legajo → POST /v1/legajos

Actualización → PATCH /v1/legajos/{id_carpeta}

Los campos ausentes no se tocan. "contenedores": [] borra todos; con items reemplaza la lista.

Alta de evento → POST /v1/legajos/{id_carpeta}/eventos

Subir archivo → POST /v1/legajos/{id}/archivos

Usá sub_carpeta O el par id_evento + id_registro (de POST .../eventos). El archivo queda descargable y se encola para bajar al disco G: (estado_g).
Filtros: id_cliente (opcional), dias de ventana hacia atrás (default 30 con cliente, 10 sin; máx 90), desde (YYYY-MM-DD, pisa a dias). Devuelve una fila por carpeta con carga: fechas crudas, flags (IMO, atención, inspección/foto precinto solo Ferrero) y tarjetas[] ya resueltas (carga / verificación / control documental) para dibujar el calendario. Fechas en hora local Argentina, sin zona horaria.
Filtros: q (razón social / CUIT / nro imp-exp), activo (ausente = solo activos, 0 = inactivos, todos = sin filtro), limit, offset.
El detalle no filtra por activo: devuelve también clientes dados de baja (con "activo": false).
Filtros: activo, id_perfil, id_sector, q (LIKE parcial sobre nombre/usuario/email), email (igualdad exacta), limit, offset. No devuelve password. Ej: email=j.perez@portas.com.ar.
El detalle individual SÍ incluye el campo password.

Alta usuario → POST /v1/usuarios

Otros campos demográficos (direccion, telefonos, documento, cuil, legajo…) se pueden agregar editando el JSON con el modo crudo del PATCH; aquí mostramos los más usados.

Actualizar usuario → PATCH /v1/usuarios/{id}

Ausente = no tocar. Permite cambiar password.

Login → POST /v1/usuarios/login

Compara igualdad exacta contra el valor guardado. Devuelve el usuario sin el hash, o 401.

3. Llamada generada

# Elegí la operación y presioná Ejecutar

4. Resultado

# Acá aparece la respuesta del servidor