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

# Authentication

> Autenticati con una chiave API Bearer e limita i retry con chiavi di idempotenza stabili.

# Autenticazione

L’API utilizza l’autenticazione Bearer con una chiave API Youka. Creane una su [online.youka.io/account](https://online.youka.io/account) nella sezione **API keys**.

## Invia la chiave API

```http theme={null}
Authorization: Bearer yk_...
```

## Configurazione consigliata del client

* Conserva la chiave API fuori dal tuo albero dei sorgenti.
* Iniettala in fase di esecuzione tramite variabili d’ambiente o un secrets manager.
* Invia l’header a ogni richiesta, incluse le richieste di polling.

## Esempio

```bash theme={null}
curl https://api.youka.io/it/api/v1/projects/proj_123 \
  -H "Authorization: Bearer yk_..."
```

## Documentazione correlata

* [Node.js SDK quickstart](/it/sdk)
* [Raw HTTP quickstart](/it/api/quickstart)
* [Idempotency](/it/api/idempotency)
* [Errors and retries](/it/api/errors)