{/*
  AUTO-GENERADO por scripts/import-corpus.mjs a partir de manuales/corpus/ — NO EDITAR A MANO.
  Portada del grupo "guides/claves-api" (site "tenant") — ver scripts/nav-map.json.
*/}

import { CardGrid, LinkCard } from '@astrojs/starlight/components';

Una clave de API es una credencial secreta que te permite llamar a la API REST de la Plataforma desde tu propio código (un script, un backend, un CRM externo…) sin pasar por el formulario de login: en vez de email y contraseña, tu integración envía la clave en cada petición HTTP. Es el mecanismo pensado para integraciones M2M (máquina a máquina) — automatizaciones, sincronizaciones con otros sistemas, scripts internos de tu negocio — nunca para que una persona inicie sesión con ella en la propia Plataforma.

<CardGrid>
  <LinkCard
    title="Qué son las claves de API y para qué sirven"
    description="Una clave de API es una credencial secreta que te permite llamar a la API REST de la Plataforma desde tu propio código (un script, un backend, un CRM externo…) sin pasar por el fo…"
    href="/guides/claves-api/01-que-son-las-claves-de-api-y-para-que-sirven/"
  />
  <LinkCard
    title="Los dos tipos de clave"
    description="La Plataforma distingue dos tipos de clave según su propietario."
    href="/guides/claves-api/02-los-dos-tipos-de-clave/"
  />
  <LinkCard
    title="Requisitos previos"
    description="Suscripción activa de tu agencia (una clave con la cuenta bloqueada por facturación no puede usarse — mismo bloqueo que el resto de la Plataforma)."
    href="/guides/claves-api/03-requisitos-previos/"
  />
  <LinkCard
    title="Procedimiento: crear una clave personal"
    description="Requisitos: ninguno especial — cualquier rol puede crear claves para sí mismo."
    href="/guides/claves-api/04-procedimiento-crear-una-clave-personal/"
  />
  <LinkCard
    title="Procedimiento: crear una clave de la empresa"
    description="Requisitos: rol Admin."
    href="/guides/claves-api/05-procedimiento-crear-una-clave-de-la-empresa/"
  />
  <LinkCard
    title="Orígenes permitidos"
    description="Cada clave tiene una lista opcional de orígenes permitidos: los dominios (hostnames) desde los que se acepta usarla cuando la petición llega con cabecera Origin (es decir, desde u…"
    href="/guides/claves-api/06-origenes-permitidos/"
  />
  <LinkCard
    title="Qué puede hacer cada clave: permisos y el picker «Personalizar»"
    description="Ninguna clave lleva permisos «a la carta» por defecto: hereda un conjunto de permisos ya definido, sellado en el momento de crearla (apartado 2)."
    href="/guides/claves-api/07-que-puede-hacer-cada-clave-permisos-y-el-picker-personalizar/"
  />
  <LinkCard
    title="Expiración"
    description="Al crear la clave eliges cuánto dura: Nunca, 30, 90 o 365 días."
    href="/guides/claves-api/08-expiracion/"
  />
  <LinkCard
    title="Revocación"
    description="No existe un «borrar» clave: solo revocar."
    href="/guides/claves-api/09-revocacion/"
  />
  <LinkCard
    title="Uso: autenticación con X-API-Key"
    description="Una vez tienes la clave, autentica cada petición añadiendo la cabecera X-API-Key con el valor completo de la clave."
    href="/guides/claves-api/10-uso-autenticacion-con-x-api-key/"
  />
  <LinkCard
    title="Límites de peticiones (rate limit)"
    description="Además de los límites generales que ya se aplican a cualquier petición (por tenant, por usuario o por IP, según el caso), toda petición que incluya la cabecera X-API-Key recibe un…"
    href="/guides/claves-api/11-limites-de-peticiones-rate-limit/"
  />
  <LinkCard
    title="Errores comunes y su solución"
    description="Código · Cuándo ocurre · Qué hacer"
    href="/guides/claves-api/12-errores-comunes-y-su-solucion/"
  />
  <LinkCard
    title="Buenas prácticas de custodia"
    description="No la compartas por chat, email sin cifrar, ni la pegues en ningún sitio público."
    href="/guides/claves-api/13-buenas-practicas-de-custodia/"
  />
  <LinkCard
    title="Preguntas frecuentes"
    description="¿Puedo tener varias claves personales a la vez?"
    href="/guides/claves-api/14-preguntas-frecuentes/"
  />
</CardGrid>