Usar la API pública

La API pública de Upsellr da acceso a su master data, sus productos, sus fuentes y sus workflows desde sus propias herramientas. Está incluida en la oferta Enterprise.

Lo esencial

• Dirección base: https://api.upsellr.io/v2
• Autenticación: cada petición lleva la cabecera Authorization con el valor Bearer seguido de su clave. Consulte crear y gestionar claves API.
• Documentación: la referencia completa, con ejemplos, está publicada en docs.upsellr.io.

Llamadas solo desde un servidor

La API se llama desde un servidor, nunca desde un navegador: no responde a las peticiones enviadas por una página web. Así también se evita exponer su clave en el código de una página.

Los límites de frecuencia

Los límites se aplican a toda la organización, sumando todas las claves.

Tipo de petición	Por minuto	Ráfaga
Lecturas	200	30
Escrituras	60	10
Escrituras pesadas: creación de productos, subida de archivo, lanzamiento de workflow	20	5
Búsqueda y lectura de productos	60	5

Por encima, la API responde con el código 429 y una cabecera Retry-After que indica, en segundos, cuándo volver a intentarlo.

Identificador de petición

Cada respuesta lleva una cabecera X-Request-Id. Si una petición falla de forma inesperada, anote este identificador y transmítalo al soporte: permite encontrar exactamente su llamada.

A tener en cuenta

• Una clave limitada a ciertas direcciones IP o ciertos User-Agents se rechaza desde cualquier otro origen.
• Demasiadas peticiones con una clave no válida desde una misma dirección provocan un bloqueo temporal, señalado con un código 429.
• Una clave solo actúa dentro de los límites de sus permisos: una petición fuera de ellos se rechaza.
• Lanzar un workflow mediante la API consume créditos igual que desde la aplicación.
• Para recibir un aviso del final de una ejecución sin consultar la API en bucle, use los webhooks.
• ¿Tiene una pregunta? Pase por contáctenos o por el botón Informar de un error de la app, con el identificador de petición.