> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clausum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claves API

> Claves publicables, secretas y de ingestión de webhooks desde Conexiones

Clausum usa **tres tipos de claves**. Los prefijos (`clm_pub_`, `clm_sk_`, `clm_wh_`) identifican la clase de clave — créalas en **Panel de Control → Conexiones**.

## De un vistazo

<CardGroup cols={3}>
  <Card title="Publicable (navegador)" icon="globe">
    **Prefijo:** `clm_pub_`\
    **Usar para:** SDK de navegador y assess del lado del cliente.\
    **Nunca para:** Reportar fraude, payout ni API de comercio.
  </Card>

  <Card title="Secreta (servidor)" icon="server">
    **Prefijo:** `clm_sk_`\
    **Usar para:** Assess en servidor, payout, reportar fraude, endpoints de comercio.\
    **Nunca en:** Bundles de navegador o móvil.
  </Card>

  <Card title="Ingestión de webhooks" icon="inbox">
    **Prefijo:** `clm_wh_`\
    **Usar para:** Solo `POST /api/webhooks/ingest`.\
    **No para:** Assess ni SDK.
  </Card>
</CardGroup>

## Crear claves

<Steps>
  <Step title="Abrir Conexiones">
    Inicia sesión en [sandbox.clausum.ai](https://sandbox.clausum.ai) (o tu panel de producción) → **Conexiones**.
  </Step>

  <Step title="Elegir la pestaña">
    * **Claves API** → claves partner publicables o secretas
    * **Empezar** → URL de webhook saliente (tarjeta **Webhooks salientes**)
    * **Entrada (webhooks)** → clave de ingest genérico (`clm_wh_*`) primero; guías por procesador opcionales
  </Step>

  <Step title="Copiar una sola vez">
    Clausum muestra la clave completa **una sola vez**. Guárdala en tu gestor de secretos de inmediato.
  </Step>

  <Step title="Configurar CLAUSUM_API_BASE">
    Usa el hostname de tu etapa — consulta [Acceso y entornos](/es/concepts/access-and-environments).
  </Step>
</Steps>

<Warning>
  Las claves de **ingestión** y **secretas** no son intercambiables. Assess con `clm_wh_*` devuelve `401`.
</Warning>

## Permisos predeterminados

| Etiqueta | Prefijo | Permisos predeterminados |
| - | - | - |
| Publicable | `clm_pub_` | `assess` |
| Secreta | `clm_sk_` | assess, reporte de fraude, scopes de comercio, contribución a red |
| Ingestión | `clm_wh_` | solo ingestión |

Los límites de tasa por clave son configurables al crear claves secretas (`rate_limit_per_minute`, `rate_limit_per_day`).

## Claves de inteligencia de red

Para participar en la [red de inteligencia Clausum](/es/guides/clausum-intelligence-network):

| Permiso | Uso |
| - | - |
| `network:contribute` | `POST /api/v1/network/intelligence` — publicar señales compartidas |
| `network:signals:read` | `GET /api/v1/network/intelligence` — estadísticas de tus contribuciones |
| `fraud:report` | Permiso alternativo para publicación de señal única o [Reportar fraude](/es/guides/report-fraud) |

Los bancos y PSP suelen usar una `clm_sk_*` con `assess` + `network:contribute` en el middleware central.

<Note>
  **Consumir** señales de pares en assess requiere el contrato **CLM-ADD-NET-C** — habilitado por Clausum, no solo por permiso de clave.
</Note>

## Solución de problemas

Si Conexiones aparece vacío tras el onboarding, contacta a **[api@clausum.ai](mailto:api@clausum.ai)** con el nombre de tu organización — el aprovisionamiento del workspace puede estar en curso.

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Inicio rápido" icon="rocket" href="/es/quickstart">
    Primera llamada assess.
  </Card>

  <Card title="Autenticación" icon="lock" href="/es/concepts/authentication">
    Encabezados, permisos, errores.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.