Autenticación
Las claves de API pertenecen a un espacio de trabajo, tienen un alcance de lectura o de lectura y escritura, y viajan como token bearer.
Crea una clave
En el panel, abre Configuración, Desarrolladores y haz clic en Crear clave de API. Ponle el nombre del sistema que la va a usar, elige los permisos y copia la clave cuando aparezca. Solo se muestra una vez.
- Las claves de Solo lectura pueden llamar a todos los endpoints
GET. - Las claves de Lectura y escritura también pueden crear, cambiar y eliminar.
Las claves abarcan todo el espacio de trabajo: una clave ve todos los códigos, carpetas, páginas y webhooks del espacio de trabajo en el que se creó. Solo los administradores del espacio de trabajo pueden crear y revocar claves. El número de claves activas por espacio de trabajo depende del plan; GET /me informa el límite.
Envíala
curl https://api.kuikcode.com/v1/codes \
-H "Authorization: Bearer kc_live_5Yh2...Qk"Las claves empiezan con kc_live_. Cualquier otra cosa en el encabezado se rechaza con 401 invalid_api_key.
Mantenla en secreto
Trata una clave como una contraseña: solo del lado del servidor, nunca en un navegador ni en una app para celular, y nunca en un repositorio. Si una clave se filtra, revócala en el panel; las solicitudes con ella se detienen de inmediato. Al crear una clave puedes darle una fecha de vencimiento; después de esa fecha, las solicitudes fallan con 401 expired_api_key.
Requisitos del plan
La API está incluida desde el plan PRO. Si un espacio de trabajo cambia a un plan sin acceso a la API, sus claves dejan de funcionar con 403 plan_required, en lugar de mantener activa en silencio una función de pago.