La API Pública de Wisboo permite conectar aplicaciones y sistemas externos con tu tienda para gestionar información de forma programática, como usuarios, compras, productos y accesos a productos.
Con la API puedes automatizar procesos e integrar Wisboo con otros sistemas sin necesidad de realizar estas acciones manualmente desde la administración de tu tienda.
Consulta la documentación técnica
Consulta nuestra documentación técnica para conocer la estructura de datos y cómo desarrollar con el API de Wisboo.
Cómo crear una API Key
Para utilizar la API es necesario generar una API Key, que funciona como credencial de autenticación para identificar y autorizar las solicitudes realizadas a tu tienda.
Para crear una API Key:
Accede a la administración de tu tienda.
Ve a Configuración → API Keys.
Haz click en el botón rosa principal.
Genera una nueva API Key.
Guarda la clave en un lugar seguro.
Cada API Key está asociada a una tienda específica y debe utilizarse junto con el store_id correspondiente. La API Key debe enviarse en el header Authorization de cada solicitud.
Configura las IPs permitidas
Como medida adicional de seguridad, puedes definir las IPs permitidas desde las que se podrán realizar solicitudes utilizando esa API Key.
Por ejemplo, si tu integración realiza todas las solicitudes desde la IP 192.168.1.1, puedes agregarla como IP permitida. De esta forma, las solicitudes realizadas con esa API Key desde otras direcciones IP serán rechazadas.
Puedes agregar una o varias IPs al momento de crear la API Key.
Recomendación: Si conoces las direcciones IP desde las que funcionará tu integración, te recomendamos configurarlas para agregar una capa adicional de seguridad a tu API Key.
Guarda tu API Key de forma segura
Al crear una API Key, Wisboo genera una contraseña única que deberás utilizar para autenticar tus solicitudes. Es importante que copies y guardes esta contraseña en un lugar seguro inmediatamente después de crearla.
Por motivos de seguridad, Wisboo no almacena esta información de forma que pueda volver a mostrártela, por lo que no podrás consultarla posteriormente desde la plataforma. Si pierdes la contraseña, deberás eliminar la API Key y crear una nueva.
⚠️ Importante: Trata tu API Key como una credencial privada. No la compartas ni la incluyas en código público o repositorios accesibles por terceros.
Consulta los logs de API
Wisboo registra las solicitudes realizadas a través de la API para que puedas monitorear su actividad y diagnosticar posibles errores.
Desde el listado de API Keys creadas puedes hacer click en el botón de "Ver logs". Dentro puedes consultar el listado de solicitudes y filtrarlas por:
Ruta
Código de respuesta
Método HTTP
Al seleccionar una solicitud puedes consultar información más detallada, como:
Código de respuesta de la solicitud.
Fecha y hora.
Dirección IP desde la que se realizó la solicitud.
API Key utilizada.
Headers de la solicitud.
Cuerpo de la solicitud.
Cuerpo de la respuesta.
Esta información puede ser especialmente útil para identificar errores, verificar solicitudes y entender qué información se envió y recibió en una operación determinada.
Endpoints disponibles
La API Pública utiliza como URL base:
https://api.wisboo.com/v1
Todos los endpoints se encuentran asociados a una tienda mediante su store_id.
Actualmente puedes utilizar la API para trabajar con:
Usuarios: consultar, crear y actualizar usuarios.
Compras: consultar compras.
Accesos a productos: consultar, otorgar, actualizar o revocar accesos.
Productos: consultar productos.
Webhooks: gestionar integraciones relacionadas con Webhooks.
Para consultar los endpoints disponibles, parámetros, ejemplos de requests y respuestas, revisa nuestra documentación técnica de la API Pública.
Rate limit
Para garantizar la estabilidad y disponibilidad del servicio, la API Pública tiene un límite de solicitudes (rate limit) por API Key.
Actualmente, el límite para el plan Business es de 500 requests por minuto.
Cuando se supera este límite, la API devuelve una respuesta 429 Too Many Requests. Las respuestas incluyen headers que permiten conocer el límite actual, la cantidad de solicitudes restantes y cuándo se restablece.
Si tu integración recibe un 429, te recomendamos implementar reintentos utilizando exponential backoff. Nota: El límite puede cambiar en el futuro. Consulta la documentación técnica para conocer el comportamiento actualizado de la API.