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.
Updated 2 months ago