La API de Aliaddo Orka utiliza autenticación mediante token Bearer. Para consumir cualquier endpoint debes generar un token desde el portal y enviarlo en el encabezado Authorization de cada solicitud.
Objetivo de esta guía#
En este paso a paso aprenderás a:Ingresar al portal de Aliaddo Orka.
Ubicar el módulo de integración.
Generar un token de acceso para una organización.
Copiar el token y usarlo correctamente en tus peticiones a la API.
Antes de comenzar#
Ten en cuenta lo siguiente:Debes contar con credenciales de acceso al portal.
Debes saber para qué organización necesitas generar el token.
El token generado debe tratarse como información sensible.
Paso a paso para generar el token de acceso#
1. Inicia sesión en el portal#
Ingresa al portal de Aliaddo Orka desde el siguiente enlace:
2. Selecciona la organización#
Después de iniciar sesión, elige la organización con la que vas a trabajar. Esta selección es importante porque el token quedará asociado a esa organización.
3. Abre el módulo de integración#
Una vez dentro del sistema, dirígete al menú lateral y haz clic en la opción Integración.
4. Ingresa al administrador de tokens#
Ubica la organización para la que deseas habilitar acceso a la API y haz clic en el botón Ver tokens.Si lo prefieres, también puedes ingresar directamente desde este enlace:
Generar token 👉 Ya debes estar autenticado en el portal.
5. Haz clic en "Generar nuevo token"#
Dentro de la pantalla de administración de tokens, presiona el botón Generar nuevo token para iniciar el proceso.
6. Agrega una descripción opcional#
Escribe una descripción breve que te permita identificar fácilmente el propósito del token, por ejemplo: Integración ERP, Pruebas QA o Producción facturación.Este campo es opcional, pero se recomienda usarlo para facilitar la administración de los tokens creados.7. Confirma la generación del token#
Haz clic en Generar token. El sistema creará un token único asociado a la organización seleccionada.8. Copia y guarda el token#
Una vez generado, copia el token y consérvalo en un lugar seguro. Este valor será necesario para autenticar cada solicitud enviada a la API.Recomendaciones importantes#
Guarda el token en un lugar seguro.
No compartas el token en correos, chats o documentación pública.
Usa descripciones claras para identificar cada token.
Si sospechas que un token fue expuesto, reemplázalo de inmediato.
Cómo usar el token en la API#
Cada solicitud debe incluir estos encabezados:| Header | Tipo | Requerido | Descripción |
|---|
Authorization | string | Sí | Token Bearer generado desde el portal |
Content-Type | string | Sí | application/json |
También puedes enviarlo así en una petición HTTP:
Resultado esperado#
Si el token es válido y se envía correctamente en el header Authorization, la API permitirá procesar la solicitud según los permisos asociados a la organización. Modificado en 2026-03-10 17:51:35
