Saltar al contenido principal

​
URL base

​
Producción

RecursoURL
Aplicación (panel y tokens de integración)https://app.unisaldos.com/
API de integraciones (base para rutas /v1/...)https://api.unisaldos.com/
Documentación (este sitio en producción)https://docs.unisaldos.com/
Las peticiones a la API de integraciones usan como URL base la de API de integraciones de la tabla anterior (sin path adicional antes de /v1).

​
Autenticación

Incluye en cada petición: 
Authorization: Bearer TU_TOKEN_PLANO
Si el token no es válido, recibirás 401. Si es válido pero no incluye el permiso requerido por el endpoint, la respuesta será 403 con un cuerpo que incluye required_scope con el nombre del permiso que falta. Un 422 aparece cuando los datos de la petición no cumplen el esquema (JSON, query o path: tipos, campos obligatorios, formatos). Es el comportamiento habitual de validación. Revisa el detalle del error y alinea cuerpo o parámetros con la operación en OpenAPI antes de reintentar.

​
Crear y administrar tokens

Los tokens no se crean ni se administran con esta API de integraciones. Ese proceso es 100 % interfaz: en app.unisaldos.com, dentro del espacio de tu empresa, encontrarás la sección para integraciones API. Ahí eliges la empresa, creas o editas claves, y marcas qué permisos tendrá cada una; no hace falta llamar a otra API para configurar scopes ni listar opciones. Necesitas un usuario con derechos para gestionar esas claves en dicha empresa. Desde el mismo flujo podrás listar las claves existentes, crear una nueva (y copiar su valor al momento), ajustar etiqueta o permisos y revocar una clave que ya no uses.
El valor completo del token solo se muestra una vez, justo al crearlo en la aplicación. Guárdalo de inmediato en un gestor de secretos o en variables de entorno protegidas. Si lo pierdes, crea otra clave y actualiza tus integraciones.

​
Primera petición

Sustituye TU_TOKEN. En producción la URL base es https://api.unisaldos.com: 
curl -sS -H "Authorization: Bearer TU_TOKEN" \
  "https://api.unisaldos.com/v1/company"
Si el token incluye el permiso integrations:v1:company:read, obtendrás los datos de la empresa vinculada al token. Los demás permisos integrations:v1:... y una tabla resumida están en la guía Permisos de la API. Para búsqueda, filtros, paginación y ordenación en respuestas GET en lista, consulta Búsqueda y paginación. Para adjuntos de transacciones (multipart/form-data, permisos de adjuntos), consulta Archivos adjuntos.