Preguntas Frecuentes (FAQs)

En esta sección encontrarás respuestas claras y sencillas a las preguntas más comunes sobre nuestras APIs y la plataforma Talana. La idea es que puedas resolver tus dudas rápidamente y continuar con tu trabajo sin interrupciones. Si no encuentras lo que buscas, siempre puedes contactarnos y con gusto te ayudaremos.

¿Cómo obtengo mis credenciales de acceso a la API?

Debes solicitarlas escribiendo directamente al nuestro SAC.

El equipo te guiará para obtener tu API Key o acceso mediante OAuth2 según corresponda.


¿Cuáles son las cuotas de uso (Rate Limit) de la API?

A continuación te detallamos los límites y el comportamiento esperado:

  • 0 a 20 requests por minuto
    El consumo está dentro del rango recomendado. No se esperan problemas de performance ni restricciones.
  • ⚠️ 21 a 50 requests 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 requests 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.


¿Cómo pruebo los endpoints antes de integrar?

Utiliza el “Try it” en la sección Api Reference de este portal, o importa nuestra colección de Postman para pruebas locales.


¿Qué hago si recibo un error 401 o 403 (Unauthorized/Forbidden)?

  • Verifica que tu token/API Key sea válido y esté bien colocado en el header Authorization.
  • Chequea los permisos de tu usuario o integración.
  • Si el error persiste, escribe a los correos de soporte indicados.

¿Talana ofrece un ambiente de pruebas (sandbox)?

Sí. Solicita acceso indicando tu motivo de integración y recibirás las credenciales y endpoints sandbox.


¿Dónde encuentro ejemplos de requests y respuestas?

  • En cada endpoint de API Reference.
  • En las secciones de guías de este portal.

¿Cómo reporto un problema o sugiero una mejora?

Ponte en contacto de forma inmediata con nuestro SAC.

Incluye detalle del problema, endpoint, ejemplo de request/response y contexto técnico.


¿Cómo funcionan las versiones de la API?

La versión activa de cada API se indica en la ruta o en la documentación. Cambios importantes son anunciados en la sección Changelog.


¿Dónde obtengo soporte técnico

Ponte en contacto de forma inmediata con nuestro SAC.


📝

¿Tienes más dudas? Ingrésala en la sección de Foro para sumarla a esta sección y así apoyar a otros usuarios.