API Portas — Documentación

Las cuatro APIs

Comparten servidor, versión y esquema de credenciales, pero cada una atiende a un consumidor distinto. La de Web es la más nueva: nació con la migración del escritorio Symfony.

API	Para qué sirve	Prefijo	Documentación	Probar en vivo
Web (Escritorio)	Endpoints que consume `escritorio.portascloud.ar`, la aplicación para probar los endpoints que se van a utilizar en `importas.com.ar`: operaciones, arribos, documentos, notificaciones y los ocho reportes con exportación a Excel.	`/v1/web/…`	Ver documentación	— necesita sesión, ver abajo
Móvil	El sector móvil del sistema viejo (app Symfony `smatphone`), para que lo reimplemente `importas.com.ar`. No usa sesión: cada llamada trae `id_usuario`, porque el login lo hace importas contra sus propias tablas.	`/v1/movil/…`	Ver documentación	Abrir playground
Datos	Legajos y usuarios: consulta y alta/actualización, en reemplazo de la conexión directa a la base y de las llamadas posicionales a stored procedures. Incluye cronograma y ETA de contenedores.	`/v1/legajos`, `/v1/usuarios`…	Ver documentación	Abrir playground
Archivos	Subir, listar y descargar los archivos de las carpetas operativas. Es la que usa el Sincronizador para publicar la documentación desde la red de Portas.	`/v1/operaciones/…`	Ver documentación	Abrir playground

Probar en vivo

Los playgrounds arman la llamada, la disparan contra la API real y muestran la respuesta tal cual vuelve. Son la forma corta de entender un endpoint sin escribir código.

Playground Móvil Playground de Datos Playground de Archivos

La API Web todavía no tiene playground. Sus endpoints piden dos credenciales — la API key en Authorization y el token de usuario en X-Sesion — mientras que los dos playgrounds actuales solo manejan la key. Uno para la API Web tendría que hacer primero POST /v1/web/login y arrastrar el token en cada llamada.

Dos niveles de credencial

Conviene tenerlo claro antes de probar cualquier cosa, porque es lo que explica por qué una misma llamada devuelve datos o no devuelve nada:

Credencial	Va en	Qué identifica
API key	`Authorization`	La aplicación que llama. Sola no da acceso a los datos de ningún cliente.
Token de sesión	`X-Sesion`	El usuario que abrió sesión. Es lo que decide qué operaciones ve: el personal de Portas ve todas, un cliente solo las suyas.