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

Una chiave API è una credenziale segreta che ti permette di chiamare l'API REST della Piattaforma **dal tuo
codice** (uno script, un backend, un CRM esterno…) senza passare dal modulo di accesso: invece di email e
password, la tua integrazione invia la chiave in ogni richiesta HTTP. È il meccanismo pensato per
**integrazioni M2M** (macchina a macchina) — automazioni, sincronizzazioni con altri sistemi, script
interni della tua attività — mai perché una persona acceda con essa all'interfaccia web della Piattaforma
stessa.

<CardGrid>
  <LinkCard
    title="Cosa sono le chiavi API e a cosa servono"
    description="Una chiave API è una credenziale segreta che ti permette di chiamare l'API REST della Piattaforma dal tuo codice (uno script, un backend, un CRM esterno…) senza passare dal modulo "
    href="/it/guides/claves-api/01-que-son-las-claves-de-api-y-para-que-sirven/"
  />
  <LinkCard
    title="I due tipi di chiave"
    description="La Piattaforma distingue due tipi di chiave secondo il loro proprietario."
    href="/it/guides/claves-api/02-los-dos-tipos-de-clave/"
  />
  <LinkCard
    title="Requisiti preliminari"
    description="Abbonamento attivo della tua agenzia (una chiave con l'account bloccato per fatturazione non può essere"
    href="/it/guides/claves-api/03-requisitos-previos/"
  />
  <LinkCard
    title="Procedura: creare una chiave personale"
    description="Requisiti: nessuno in particolare — qualsiasi ruolo può creare chiavi per sé stesso."
    href="/it/guides/claves-api/04-procedimiento-crear-una-clave-personal/"
  />
  <LinkCard
    title="Procedura: creare una chiave dell'azienda"
    description="Requisiti: ruolo Admin."
    href="/it/guides/claves-api/05-procedimiento-crear-una-clave-de-la-empresa/"
  />
  <LinkCard
    title="Origini consentite"
    description="Ogni chiave ha un elenco facoltativo di origini consentite: i domini (hostname) da cui è accettato usarla quando la richiesta arriva con l'intestazione Origin (cioè, da un browser)"
    href="/it/guides/claves-api/06-origenes-permitidos/"
  />
  <LinkCard
    title="Cosa può fare ogni chiave: permessi e il selettore «Personalizza»"
    description="Nessuna chiave porta permessi «à la carte» per impostazione predefinita: eredita un insieme di permessi già definito, sigillato al momento della creazione (paragrafo 2)."
    href="/it/guides/claves-api/07-que-puede-hacer-cada-clave-permisos-y-el-picker-personalizar/"
  />
  <LinkCard
    title="Scadenza"
    description="Al momento della creazione della chiave scegli quanto dura: Mai, 30, 90 o 365 giorni."
    href="/it/guides/claves-api/08-expiracion/"
  />
  <LinkCard
    title="Revoca"
    description="Non esiste un «elimina» per la chiave: solo la revoca."
    href="/it/guides/claves-api/09-revocacion/"
  />
  <LinkCard
    title="Utilizzo: autenticazione con X-API-Key"
    description="Una volta che hai la chiave, autentica ogni richiesta aggiungendo l'intestazione X-API-Key con il valore completo della chiave."
    href="/it/guides/claves-api/10-uso-autenticacion-con-x-api-key/"
  />
  <LinkCard
    title="Limiti di richieste (rate limit)"
    description="Oltre ai limiti generali già applicati a qualsiasi richiesta (per tenant, per utente o per IP, a seconda del caso), ogni richiesta che include l'intestazione X-API-Key riceve una q"
    href="/it/guides/claves-api/11-limites-de-peticiones-rate-limit/"
  />
  <LinkCard
    title="Errori comuni e come risolverli"
    description="Codice · Quando accade · Cosa fare"
    href="/it/guides/claves-api/12-errores-comunes-y-su-solucion/"
  />
  <LinkCard
    title="Buone pratiche di custodia"
    description="Non condividerla via chat, email non cifrata, né incollarla in nessun posto pubblico."
    href="/it/guides/claves-api/13-buenas-practicas-de-custodia/"
  />
  <LinkCard
    title="Domande frequenti"
    description="Posso avere più chiavi personali contemporaneamente?"
    href="/it/guides/claves-api/14-preguntas-frecuentes/"
  />
</CardGrid>