Traducida del inglés. Si hay alguna diferencia, la página en inglés es la referencia. Leer en inglés
Autenticación
Claves API, scopes, modo de prueba y las reglas de seguridad que protegen tu tienda.
Todas las peticiones se autentican con una clave API vinculada a la tienda, enviada como token Bearer:
curl https://api.nembol.com/rest/v1/store \
-H "Authorization: Bearer nbl_live_xxxxxxxxxxxxxxxxxxxxxxxx"El propietario de la tienda crea las claves en el panel de Nembol, en Configuración → Desarrolladores. El secreto completo se muestra una sola vez, al crearla. Guárdalo en un gestor de secretos. Después solo se ven el nombre y el prefijo.
Modos de clave
| Prefijo | Modo | Comportamiento |
|---|---|---|
nbl_live_ | Live | Acceso completo; las escrituras se propagan a tus canales. |
nbl_test_ | Prueba | Todo se valida y se simula; no se guarda nada y nunca se toca ningún canal. Los resultados de canal simulados se marcan como "simulated". |
Integra primero con una clave de prueba; pasa a una clave live cuando tus flujos funcionen. Los partners también pueden ejecutar toda la integración de verdad, sin facturación, en el sandbox.
Usa tu clave en los ejemplos
Pega una clave de prueba (nbl_test_…) y cada bloque de código de este sitio la rellenará por ti. Solo se guarda en este navegador y nunca se envía a ningún sitio.
Scopes
Cada clave lleva solo los scopes que le concedes:
| Scope | Concede |
|---|---|
products:read | Leer productos, variantes y anuncios |
products:write | Crear, actualizar y eliminar productos e imágenes |
inventory:write | Actualizar solo cantidad y precio (más seguro para integraciones de sincronización de stock) |
listings:write | Publicar y retirar en cada canal |
orders:read | Leer pedidos. Incluye datos personales de los compradores, así que trátalos conforme a la ley |
orders:write | Marcar pedidos como enviados, añadir el seguimiento, avisar al marketplace |
webhooks:manage | Gestionar los endpoints de webhook |
events:read | Leer el registro de eventos |
channels:write | Cambiar los ajustes de las cuentas de canal: reglas de sincronización, regla de precio, límite de cantidad, políticas/colección por defecto |
channels:connect | Conectar y desconectar cuentas de canal, gestionar las URL de redirección que usan los enlaces de conexión |
billing:read | Leer el plan, el uso, el método de pago y las facturas de la tienda |
storefront:write | Ajustes del storefront (no pagos), códigos de descuento y packs |
promotions:write | Crear, cambiar, detener y eliminar promociones (rebajas temporales en los canales) |
billing:manage | Crear enlaces para suscribirse, cambiar de plan, actualizar la tarjeta, cancelar o renovar; reiniciar la prueba gratuita |
accounts:manage | Solo partners. Crear, cambiar y cerrar tus empresas, leer el extracto y la facturación de partner, y trabajar dentro de una empresa con el header Nembol-Account (sin este permiso, cualquier petición con ese header responde 403 insufficient_scope). Aparece en Configuración → Desarrolladores solo en una cuenta de partner, y el preset Lectura y escritura lo incluye. Consulta Programa de partners. |
Las peticiones sin el scope necesario fallan con 403 y
error.type: "authentication_error".
Reglas de seguridad
- Nunca uses claves API en código de navegador o móvil. La API es de servidor a servidor; los navegadores están bloqueados por CORS a propósito (el único origen permitido es el playground de esta documentación).
- Una clave por integración. No compartas claves entre sistemas, así puedes rotar una sin romper las demás.
- Rota la clave de inmediato si se filtra (panel → clave → Rotar): el secreto anterior deja de funcionar al momento, y recibes un secreto nuevo que se muestra una sola vez.
- Las claves se pueden revocar en cualquier momento; la revocación es inmediata.
Última actualización el 20 de octubre de 2026
¿Necesitas ayuda?
Escríbenos y te responde una persona, normalmente en un día laborable.