Claves de API

Introducción

Las claves de API permiten conectar Orca Clinic con sistemas externos (software de gestión, herramientas de automatización como n8n, etc.) mediante autenticación segura.

Objetivo

Generar y gestionar claves de acceso a la API REST de Orca Clinic con permisos granulares por recurso.

Cómo funciona

Desde Ajustes → Claves de API puedes crear nuevas claves con un nombre descriptivo y seleccionar los permisos (lectura/escritura de citas, pacientes, tratamientos, facturas, staff). La clave generada tiene el formato 'orca_ak_xxxxx' y solo se muestra una vez al crearla. Los sistemas externos la incluyen en la cabecera 'Authorization: Bearer orca_ak_xxxxx' de sus peticiones.

Paso a paso

1. 1Ve a Ajustes → Claves de API.
2. 2Haz clic en '+ Nueva clave'.
3. 3Escribe un nombre descriptivo (p. ej., 'Integración n8n').
4. 4Selecciona los permisos necesarios (principio de mínimo privilegio).
5. 5Copia y guarda la clave generada; no se puede recuperar después.
6. 6Para revocar una clave, haz clic en el icono de eliminar junto a ella.

Consejos

• Nunca compartas una clave de API por email o chat sin encriptar.
• Crea una clave diferente por cada integración para poder revocarlas individualmente.
• Revisa periódicamente las claves activas y elimina las que ya no uses.

Errores frecuentes