Automatización y desarrolladores
Claves API
Crear, acotar y rotar las claves que autentican el acceso a la API.
Las claves API autentican el acceso programático a PeekHire — tanto la API REST como tus automatizaciones no-code.
Crear una clave
- Ve a Herramientas para desarrolladores → Claves API → Crear.
- Pon un nombre descriptivo (p. ej. Integración de Zapier).
- Copia el valor de la clave al mostrarse — por seguridad, no podrás verlo después.
Usar una clave
Envía la clave como bearer token en cada petición:
curl https://tu-host-api/api/v1/applications \
-H "Authorization: Bearer TU_CLAVE_API"
Permisos
Cada clave lleva permisos que limitan lo que puede hacer:
- Lectura — obtener datos (listar y recuperar campañas, candidaturas, usuarios).
- Escritura — crear o modificar datos.
Concede solo lo que necesita la integración (mínimo privilegio). Una clave de solo lectura basta para sincronizar datos a una hoja de cálculo o un panel; añade Escritura solo cuando la integración tenga que cambiar algo en PeekHire.
Mantener las claves seguras
- Trata las claves como contraseñas. Cualquiera con una clave puede actuar.
- Nunca subas claves a un repositorio o código de cliente.
- Una clave por integración, para poder revocar una sin afectar al resto.
- Guarda las claves en un gestor de secretos, no en texto plano.
Rotar y revocar
Si una clave se expone — o por rutina — crea una nueva, actualiza tu integración y luego elimina la antigua. Eliminar una clave revoca su acceso de inmediato.