Restringir un endpoint según el rol de una clave

Una clave de API puede llevar un rol opcional y de formato libre, establecido al crearla en la pestaña Claves y Secretos (o añadido más tarde rotando la clave). Es solo una etiqueta de texto, "admin", "invitado", lo que tu proyecto necesite, no hay una lista fija, tú decides qué significa cada una en la lógica de tu propio endpoint.

Construir un endpoint solo para administradores

1. Crea la clave de API que entregarás a llamadores de confianza, dándole el rol admin.
2. En el grafo del endpoint, justo después del Disparador, añade un bloque de Condición con el campo apiKeyRole, operador Igual a, valor admin.
3. Conecta la conexión "Falso" a un bloque de Respuesta de Error, estado 403, cuerpo algo como {"error": "Solo administradores."}.
4. Conecta la conexión "Verdadero" al resto de la lógica real de tu endpoint.

Una solicitud sin clave de API, o una clave cuyo rol se dejó en blanco, evalúa apiKeyRole como una cadena vacía, así que toma la rama "Falso" y es rechazada, exactamente igual que cualquier otro valor que no sea admin. Activa también Requiere una clave de API en los ajustes del endpoint, de lo contrario un llamador podría alcanzarlo sin ninguna clave antes de que tu bloque de Condición llegue a ejecutarse.