API REST
API REST: su catálogo de Upsellr, gestionado desde sus propias herramientas.
Cree productos desde su ERP, envíe sus archivos de proveedores, lance el enriquecimiento y la generación y, después, lea los contenidos redactados para cada canal y cada idioma. Una API REST documentada, con claves de permisos limitados.
- Categoría
- API
- Sentido
- Lectura y escritura
- Versión
- REST v2, especificación OpenAPI
- Claves
- Hasta 10 por organización, con los permisos que elija
- Idiomas
- Etiquetas en francés, inglés, español y alemán
- Autenticación
- Clave de API en la cabecera Authorization
- Planes
- Plan Enterprise
- Editor
- Upsellr
01Lo que hace la API
Upsellr, desde sus propias herramientas.
- 01
Cree sus productos por lotes
Envíe hasta 100 productos por llamada. Upsellr los reconoce por EAN, SKU o referencia del fabricante y marca: un producto ya conocido no se duplica, sino que recibe una nueva versión si cambia algún valor.
- 02
Lea su master data
Campos, listas de valores, categorías y plantillas: lo que estructura su catálogo se lee a través de la API, con las etiquetas en su idioma.
- 03
Envíe sus archivos de proveedores
Deposite sus hojas de cálculo y sus PDF en la biblioteca de archivos de Upsellr: hasta 10 MiB en un solo envío y, por encima, en varias partes.
- 04
Lance el enriquecimiento y la generación
Inicie un proceso sobre una selección, una búsqueda o todo el catálogo, hasta 50 000 productos: Lily enriquece el master data, Max redacta las fichas de sus canales, o se ejecuta uno de sus workflows.
- 05
Lea los contenidos generados
Cada producto devuelve su master data, sus valores importados y sus contenidos generados, ordenados por canal y por idioma.
- 06
Siga sus procesos
Un proceso se sigue a través de la API o por webhook: terminado, fallido o detenido, su herramienta recibe el aviso.
02Primeros pasos
Su primera solicitud en pocos minutos.
- 01
Abra la configuración de la organización
Sección API y webhooks, reservada a los propietarios y administradores.
- 02
Cree una clave
Elija sus permisos: solo lectura, lectura y escritura, o acceso completo. Añada una fecha de caducidad y direcciones IP autorizadas si lo desea.
- 03
Conéctela a su herramienta
Se envía en la cabecera Authorization de cada llamada.
- 04
Llame a la API desde su servidor
No se llama desde un navegador: sus claves permanecen en el servidor.
- 05
Siga sus procesos
A través de la API, o con un webhook que le avisa al final de cada proceso.
03Recursos
Lo que la API permite leer y escribir.
| Recurso | Lectura | Escritura |
|---|---|---|
| Productos | Sí | Sí |
| EAN, SKU y referencia del fabricante | Sí | Sí |
| Valores del master data | Sí | Sí |
| Contenidos generados, por canal y por idioma | Sí | No |
| Campos y listas del master data | Sí | No |
| Archivos fuente | Sí | SíHasta 10 MiB, o en varias partes |
| Procesos de enriquecimiento y generación | Sí | Sí |
| Precio |
Compatibilidad y requisitos
- El plan Enterprise
- Un rol de propietario o administrador para crear las claves
- Un servidor para llamar a la API, nunca un navegador
- La cabecera Authorization: Bearer en cada llamada
- Consejo: una clave por herramienta, solo con los permisos necesarios
Usted tiene el control
Claves bajo control.
- Permisos por clave: solo lectura, lectura y escritura, o acceso completo
- Una fecha de caducidad y direcciones IP autorizadas, si lo desea
- Límites de llamadas por organización, señalados cuando se superan
- Un identificador de solicitud en cada respuesta, para el soporte
04Preguntas
Preguntas sobre la API de Upsellr.
¿La API está incluida en mi plan?
Está reservada al plan Enterprise. En los demás planes, la sección API y webhooks es visible pero está bloqueada.
¿Dónde encuentro la documentación?
La referencia de la API se genera a partir de su especificación OpenAPI, con ejemplos en curl, JavaScript, Python y Ruby.
¿Cuáles son los límites de llamadas?
Por organización: 200 lecturas y 60 escrituras por minuto, y 20 por minuto para las operaciones pesadas, como la creación de productos, el envío de archivos y el lanzamiento de procesos. Por encima, la API responde 429 con el tiempo de espera.
¿Puedo modificar o eliminar un producto a través de la API?
Todavía no. Usted crea productos, y volver a enviar un producto existente le da una nueva versión si cambia algún valor. La modificación y la eliminación se hacen en Upsellr.
¿Cómo evito los duplicados?
Upsellr reconoce cada producto por su EAN, su SKU, o su referencia del fabricante y su marca: volver a enviar el mismo producto no lo duplica.
¿Puedo lanzar el enriquecimiento desde mi herramienta?
Sí. Lance el enriquecimiento, la generación, ambos, o uno de sus workflows, sobre una selección, una búsqueda o todo el catálogo, hasta 50 000 productos por proceso.
¿Cómo sé que un proceso ha terminado?
Consulte el proceso a través de la API, o reciba un webhook cuando termine, falle o se detenga.
¿Existe un SDK?
Por ahora no: la API es una API REST clásica, y la referencia ofrece ejemplos listos para copiar.
Marcus
Amazon