Autenticación

Cada solicitud lleva tu llave de API como token de tipo bearer.

Authorization: Bearer stilo_sk_...

Cómo obtener una llave

Cualquier Creator activo de stilo puede crear llaves en Configuración › API. Al crear tu primera llave aceptas los Términos de uso de la API. Puedes tener hasta 10 llaves activas, por ejemplo una por proyecto, para revocar una sin afectar a las demás.

Las llaves no vencen, salvo que elijas 90 o 365 días al crearlas.
Ves la llave una sola vez. stilo solo guarda una huella, así que una llave perdida no se puede recuperar: crea una nueva.
Al revocar una llave, deja de funcionar de inmediato.

Permisos

Dale a cada llave solo lo que necesita.

Permiso	Permite
`catalog:read`	Marcas, productos y revisar URLs.
`links:read`	Listar y ver tus links.
`links:write`	Crear y desactivar links.
`reports:read`	Tus clics, ventas, comisiones y pagos (próximamente).

Una llave sin el permiso que pide un endpoint recibe 403 insufficient_scope.

Cómo cuidar tus llaves

Usa la llave solo desde un servidor o un script. La API no envía encabezados CORS, así que un navegador no puede llamarla directamente, y una llave en una página web la puede ver cualquiera.
Guárdala en una variable de entorno o en un gestor de secretos, nunca en tu código ni en un repositorio.
Si una llave se publica en un repositorio público de GitHub, la revocamos automáticamente.

Una llave solo puede leer tus propios datos y crear links a tiendas de stilo. No puede iniciar sesión en tu cuenta, cambiar tu configuración ni tocar tus pagos.

Errores de autenticación

Estado	type	Qué significa
401	`authentication_required`	Falta el encabezado Authorization.
401	`invalid_api_key`	Llave mal formada, revocada o vencida.
403	`access_revoked`	El acceso a la API de tu cuenta está bloqueado. Escríbenos a contacto@stilo.io.
403	`account_not_eligible`	Tu cuenta de stilo no es una cuenta de Creator activa.
403	`insufficient_scope`	La llave no tiene el permiso que necesita este endpoint.