Bienvenido al Portal de Desarrolladores Talana

Este es el espacio oficial para que puedas explorar, probar e integrar nuestras APIs de Talana. Aquí encontrarás toda la documentación y ejemplos que necesitas para sacar el máximo provecho a nuestras integraciones.

Claves para una integración exitosa con Talana

Queremos que tu proyecto sea un éxito. Por eso, te facilitamos las herramientas y la información necesaria para construir una integración robusta y estable.

Construye con confianza en nuestro sandbox

Te proporcionamos un ambiente de pruebas sandbox para que puedas experimentar, depurar y validar tu código sin preocupaciones y con total libertad.

Al utilizar nuestra API Reference, todas las llamadas de ejemplo se ejecutarán automáticamente en el ambiente sandbox, asegúrate de usar el token de autenticación correspondiente a dicho ambiente para que tus pruebas sean exitosas; sin embargo, te recomendamos utilizar herramientas como Postman, Insomnia, Apidog, etc.

Para obtener las credenciales del ambiente debes solicitarlas escribiendo directamente al nuestro SAC, el equipo te guiará para obtener tu API Key o acceso mediante OAuth2 según corresponda.

Mantén una integración fluida entendiendo las políticas en los límites de peticiones (Rate Limit)

Para garantizar un alto rendimiento, establecemos los siguientes límites en las peticiones.

✅ 0 a 20 peticiones por minuto: El consumo está dentro del rango recomendado. No se esperan problemas de performance ni restricciones.
⚠️ 21 a 50 peticiones por minuto: Comportamiento aceptable, pero se recomienda optimizar el uso para no acercarse al límite. Un uso elevado podría afectar la estabilidad.
🚨 Más de 50 peticiones por minuto: Comportamiento excesivo. Si superas este límite, recibirás un error HTTP 429 ("Too Many Requests") y el acceso a esa URL será bloqueado por 10 minutos. Todas las solicitudes durante ese período serán rechazadas con el mismo error.

Si tienes dudas sobre tus cuotas o necesitas un límite personalizado, contáctanos.

¿Qué puedes hacer aquí?

Consultar la sección **Api Reference ** agrupado por producto y dominio.
Probar endpoints directamente con el explorador interactivo (Try it).
Aprender cómo autenticarse con API Keys o OAuth2.
Seguir guías prácticas de integración paso a paso.
Consultar ejemplos y casos de uso reales.

Primeros pasos

Revisa la sección "API Reference" para ver los endpoints disponibles.
Lee la guía de "Autenticación" para obtener y usar tus credenciales.
Sigue un "Ejemplo de integración" para realizar tu primera llamada.
Si tienes dudas, revisa la sección "Preguntas Frecuentes".

¿Necesitas ayuda?

Si eres cliente de Talana solicita ayuda por el chat de atención al cliente

¡Gracias por construir sobre Talana!
El equipo de Integraciones 🚀