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

# Autenticare le richieste

> Chiavi Developer Platform, autorizzazioni, scadenza e gestione sicura.

## Panoramica

Questa pagina spiega autenticazione, autorizzazioni, scadenza e conservazione delle chiavi Developer Platform. Ogni chiave appartiene a un progetto e consente solo le operazioni autorizzate.

## Usare una chiave Developer Platform

Invia questo header Authorization con ogni richiesta.

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

Le chiavi delle impostazioni ordinarie del team usano spazi di lavoro, relative autorizzazioni e crediti NoimosAI. Le chiavi Developer Platform usano progetti, autorizzazioni e saldi prepagati in USD separati.

| Chiave | Destinazione | Dati | Fatturazione |
| - | - | - | - |
| `nmp_` | Developer Platform API | Progetti sviluppatore, esecuzioni e artefatti | Saldo prepagato in USD |
| Chiave API NoimosAI ordinaria | CLI, Local MCP, API strumenti ordinaria | Spazio di lavoro NoimosAI | Crediti NoimosAI |

> [!WARNING]
>
> Le chiavi non sono intercambiabili. Chiavi non valide, autorizzazioni o saldo insufficienti non provocano cambi automatici di autenticazione o fatturazione.

## Impostare le autorizzazioni

Alla creazione seleziona le autorizzazioni necessarie.

| Autorizzazione | Operazioni consentite |
| - | - |
| `project:read` | Consultare organizzazione e progetto della chiave |
| `usage:read` | Consultare utilizzo contabilizzato e costi USD del mese corrente |
| `tools:read` | Recuperare il catalogo e preventivi gratuiti |
| `tools:execute` | Caricare input, eseguire e annullare attività a pagamento |
| `executions:read` | Recuperare stato, risultati e URL degli artefatti |

Separa le chiavi di verifica connessione da quelle di esecuzione a pagamento per limitare errori. Verifica tutti i permessi per progetto, preventivo, esecuzione e risultati.

## Chi può creare chiavi

I membri `ADMIN` o `DEVELOPER` del progetto possono crearle. Anche gli amministratori dell’organizzazione devono appartenere esplicitamente al progetto per accedervi.

Valgono le autorizzazioni del creatore e del progetto. La chiave smette di funzionare se il creatore viene disattivato o rimosso dal progetto, oppure se la chiave viene revocata.

## Gestire la scadenza

Scegli la scadenza nella schermata di creazione della chiave di Developer Platform e verificala nell’elenco dopo la creazione. La chiave completa appare una sola volta: salvala in sicurezza prima di chiudere la schermata.

Prima della scadenza crea una nuova chiave, aggiorna gli utilizzi e revoca la vecchia. Revoca subito in caso di possibile divulgazione.

## Conservare le chiavi in sicurezza

Tratta le chiavi come segreti del server, mai distribuiti ai browser degli utenti.

* Usa variabili d’ambiente o un gestore di segreti.
* Non registrarle in Git, log, schermate di errore o eventi analitici.
* Non incorporarle in app web o mobili.
* Separa chiavi e progetti per produzione, collaudo e sviluppo.
* Crea chiavi per uso con i soli permessi necessari.

## Risolvere errori di autenticazione

Verifica lo stato HTTP e quello della chiave.

* `401` — Verifica Authorization, chiave completa, scadenza e revoca.
* `403` — Verifica permessi richiesti e accesso del proprietario al progetto.
* `429` — Verifica limiti richieste, saldo e tetti mensili di organizzazione o progetto.

Se non sai se chiave ed endpoint corrispondono, usa `GET /tools/project` prima di inviare attività a pagamento.

## Pagine correlate

Queste pagine spiegano creazione delle chiavi e specifiche comuni.

* [Primi passi](https://docs.noimosai.com/it/developers/api/getting-started.md)
* [Riferimento API](https://docs.noimosai.com/it/developers/api/reference.md)


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