¿Cómo empezar a usar la API de Aliaddo?

🚀 Primeros pasos con la API de Aliaddo

¿Quieres conectar tus propios sistemas con Aliaddo? La API te permite automatizar procesos, sincronizar información y construir integraciones a la medida sobre tu operación contable y comercial. Todo empieza por un solo paso: autenticarte.

La API de Aliaddo utiliza el estándar OAuth2 para autenticar cada solicitud HTTP. Toda petición debe incluir el encabezado Authorization con el token asignado a tu usuario. ¡Vamos a generarlo! 👇

🔑 Pasos para obtener tu Token de Acceso

1. Inicia sesión en Aliaddo e ingresa a “Mis datos”

Ingresa a tu cuenta desde Aliaddo App.
Haz clic sobre tu nombre en la esquina superior derecha y selecciona la opción Mis datos.

2. Genera tu Token

En el menú lateral izquierdo, haz clic en la opción Integración.
Luego ve a la opción para generar el Token para integración, aqui podrás generar y copiar el token.

Proceso completo para generar el token

🧩 Cómo usar el Token en tus peticiones HTTP

El token debe enviarse codificado en Base64 dentro del header Authorization, utilizando el esquema Bearer.

Ejemplo de configuración del header:

Authorization: Bearer ZW1wbG9hcGlAYWxpYWRkby5jb206dG9rZW5lamVtcGxvYXBpMTIzNDU2Nzg5MA==

📊 Respuestas y Códigos HTTP de la API

Estos son los códigos de estado que puede devolver la API en cualquiera de tus solicitudes:

Código	Estado	Descripción
200	OK	Request exitoso.
201	Created	El recurso se creó exitosamente.
400	Bad Request	El request está mal formado. La información para crear el recurso no existe o es inválida.
401	Unauthorized	Error en autenticación. La autenticación falló o no se encontró la información para autenticar el request.
402	Payment Required	Pago requerido. La acción no se pudo realizar ya que la cuenta está suspendida o el plan actual no permite realizar la acción.
403	Forbidden	El usuario no tiene permisos para realizar la acción.
404	Not Found	No se encontró el recurso solicitado. También aplica si la cuenta está suspendida.
405	Method Not Allowed	Operación no permitida. El método HTTP es inválido para el endpoint requerido.
409	Conflict	Indica un conflicto. Ejemplo: intentar crear el mismo recurso dos veces vía PUT.
500	Internal Server Error	Ocurrió un error interno en la aplicación.
503	Service Unavailable	Servicio no disponible (ej. modo mantenimiento de la aplicación).

⏱️ Límite de peticiones (Rate Limit)

Actualmente puedes realizar 50, 100 o 150 peticiones por minuto por empresa, dependiendo de tu plan.

Si superas este límite, la API retorna el código 429 (Too Many Requests). En ese caso, debes esperar a que finalice el período actual (1 minuto) para volver a realizar llamadas.

Todas las respuestas de la API incluyen los siguientes headers para que puedas monitorear los límites del recurso que estás consumiendo:

Header	Descripción
`X-Rate-Limit-Limit`	Indica cuál es el límite de llamadas a la API.
`X-Rate-Limit-Remaining`	Indica cuántas llamadas te quedan disponibles en el período actual. Por ejemplo, si este header está en `50`, puedes hacer 50 llamadas más antes de que se reinicie el período.
`X-Rate-Limit-Reset`	Indica los segundos que faltan para que finalice el período actual.

✨ ¡Y listo!

Ya tienes tu token y sabes cómo usarlo: estás listo para empezar a construir sobre la API de Aliaddo. 🚀

¡Estamos felices de ayudarte! 🤗 Si tienes alguna duda o necesitas asistencia, no dudes en escribirnos a soporte@aliaddo.com con la descripción de tu solicitud y te daremos una respuesta personalizada. Nuestro equipo te responderá a tu correo registrado en un tiempo máximo de 48 horas.

¡Con Aliaddo, tu contabilidad en piloto automático! 🚀