# Claves de API (/es/docs/developer/api-keys)

Las claves de API te permiten autenticar solicitudes programáticas a la API REST de Sift. Cada clave tiene alcance a tu organización.

## De un vistazo [#de-un-vistazo]

| | |
| --- | --- |
| Genera claves en Settings → Connections → Developer access | ✅ |
| Envíalas en el encabezado `X-API-Key` | ✅ |
| Con alcance a tu organización | ✅ |
| Revoca cualquier clave con efecto inmediato | ✅ |
| Perfil predeterminado de Developer access | Reporting (`read`) |
| Perfiles de permisos | Reporting, Import, Write, Read and write |
| Caducidad predeterminada | 90 días |
| Recuperar una clave después de crearla | ❌ se muestra solo una vez |

## Generar una clave [#generar-una-clave]

1. Ve a **Settings → Connections → Developer access** (`/app/settings/api-keys`).
2. Elige nombre, perfil de permisos y caducidad. Crea la clave.
3. Copia la clave de inmediato: no se mostrará de nuevo.

## Usar tu clave [#usar-tu-clave]

Envía la clave en el encabezado `X-API-Key` en cada solicitud:

```http
GET https://api.getsift.ai/v0/action/list
X-API-Key: sk_live_your_key_here
```

## Alcances [#alcances]

Developer access selecciona **Reporting** de forma predeterminada, con el alcance `read`. Elige **Write** para escrituras generales o **Read and write** para ambas. El permiso de escritura general no permite importar por Custom API.

Para [Custom API](/docs/integrations/custom-api), crea una clave **Import** en **Settings → Connections → Developer → API keys**. La pestaña Setup de la fuente enlaza allí con la fuente preseleccionada. Otorga `ingest` e `ingest:read` para fuentes seleccionadas. Permite validar, importar, corregir elementos, reintentar importaciones fallidas y leer recibos. No permite leer informes ni enviar respuestas.

Usa claves separadas para importación e informes. Las opciones de caducidad son 30 días, 90 días o sin caducidad. El valor predeterminado es 90 días.


## Cuentas de servicio [#cuentas-de-servicio]

Una cuenta de servicio da a un script, una integración o una herramienta de IA su propia identidad en Sift. Úsala cuando una clave necesite más que los valores predeterminados de la organización, o cuando quieras saber qué herramienta hizo un cambio.

* **Roles.** Una cuenta de servicio tiene roles de tu organización, los mismos que das a las personas. Sus claves pueden hacer lo que esos roles permiten.
* **Acceso.** Las claves de **Solo lectura** solo pueden leer, permitan lo que permitan los roles. Las claves de **Lectura y escritura** también pueden hacer los cambios que permiten los roles.
* **Claves.** Cada cuenta puede tener varias claves, para rotarlas sin cortes. Una clave actúa como su cuenta, en la API REST y en [MCP](/docs/developer/mcp-connections).
* **Auditoría.** Los cambios hechos con sus claves muestran el nombre de la cuenta de servicio en el registro de auditoría.
* **Desactivar.** Desactiva una cuenta para detener todas sus claves a la vez. Elimínala para quitarla junto con sus claves.

Los Super Admins gestionan las cuentas de servicio en **Configuración → Conexiones → Acceso para desarrolladores → Cuentas de servicio**. Empieza con **Solo lectura** (lo que ve un Manager, sin cambios), **Administrador** (el rol Super Admin, lectura y escritura) o **Personalizado**.

Una cuenta de servicio no puede actuar sobre los elementos propios de una persona, como su perfil, sus paneles o sus conexiones MCP. No puede crear cuentas de servicio ni claves.

## Revocar una clave [#revocar-una-clave]

Puedes revocar cualquier clave en cualquier momento desde la misma página de configuración **Developer access**. Las solicitudes nuevas fallan después de la revocación. No asumas que revocar una clave cancela una solicitud que ya está en curso.

## Buenas prácticas [#buenas-prácticas]

* **Una clave por integración.** No compartas una sola clave entre varios sistemas. Si una integración se ve comprometida, puedes revocar solo esa clave sin afectar las demás.
* **Rota con regularidad.** Genera una clave nueva, actualiza tu integración y luego revoca la anterior.
* **Nunca confirmes claves en el control de versiones.** Guárdalas en variables de entorno o en un gestor de secretos.

<Callout type="warn">
  Trata las claves de API como contraseñas: nunca las pegues en chats, registros ni repositorios públicos.
</Callout>

## Relacionado [#relacionado]

<Cards>
  <Card href="/docs/developer/api" title="API">Usa tu clave para llamar a los endpoints de la API REST.</Card>
  <Card href="/docs/developer/query-syntax" title="Sintaxis de consultas">Filtra los resultados que devuelven tus solicitudes autenticadas.</Card>
</Cards>