Permisos y alcances - StockShift Developers

En cada llamada se hacen dos comprobaciones, y ambas tienen que pasar:

El miembro detrás del token necesita el permiso, como catalog.items.create. Los permisos vienen del rol del miembro en la organización.
El token necesita el alcance, como catalog:write. Los alcances se eligen al crear la clave o cuando un miembro aprueba una app OAuth.

Una clave con catalog:write sigue sin poder crear artículos si el rol de su propietario no lo permite, y la clave de un propietario limitada a inventory:read no puede registrar ajustes. Cualquiera de los dos fallos responde 403 con el código forbidden. Cada endpoint de la referencia de la API indica el permiso y el alcance que necesita.

Alcances

Los alcances vienen en pares de lectura y escritura para cada área de la app. Lectura cubre todo lo que solo consulta. Escritura cubre todo lo que cambia algo. Una clave de API también puede tener *, que equivale a todos los alcances; una app OAuth no.

Área	Alcances
Acceso	`access:read`
Historial de auditoría	`audit:read`
Direcciones	`address:read`, `address:write`
Automatización	`automation:read`, `automation:write`
Facturación	`billing:read`
Catálogo	`catalog:read`, `catalog:write`
Panel	`dashboard:read`, `dashboard:write`
Desarrolladores	`developer:read`, `developer:write`
Dispositivos	`devices:read`, `devices:write`
Documentos	`documents:read`, `documents:write`
Ingeniería	`engineering:read`, `engineering:write`
Análisis	`insights:read`, `insights:write`
Integraciones	`integrations:read`, `integrations:write`
Inventario	`inventory:read`, `inventory:write`
Etiquetas	`labels:read`, `labels:write`
Biblioteca de productos	`library:read`
Fabricación	`manufacturing:read`, `manufacturing:write`
Notificaciones	`notifications:read`, `notifications:write`
Organización	`organization:read`, `organization:write`
Planificación	`planning:read`, `planning:write`
Compras	`purchasing:read`, `purchasing:write`
Calidad	`quality:read`, `quality:write`
Ventas	`sales:read`, `sales:write`
Sincronización	`sync:read`, `sync:write`

Dale a cada clave solo los alcances que necesita para su trabajo. Una clave que alimenta un panel de existencias necesita inventory:read y nada más.

Límites del plan

Algunas funciones dependen del plan de la organización. Una llamada a una función que el plan no incluye responde 403 con el código plan_upgrade_required, y feature indica qué falta. No se escribe nada.