---
title: Guida introduttiva | RunAPI
description: Crea e gestisci chiavi API standard e guardrail con una chiave di gestione
  RunAPI.
url: https://runapi.ai/it/docs/guides/platform-management/quickstart.md
canonical: https://runapi.ai/it/docs/guides/platform-management/quickstart
locale: it
---

> Versione HTML: https://runapi.ai/it/docs/guides/platform-management/quickstart
> Indice del sito per gli agenti: https://runapi.ai/llms.txt

# Guida introduttiva

La Gestione della piattaforma consente agli amministratori dell'account di creare, esaminare, aggiornare
e revocare Chiavi API standard e guardrail senza dover utilizzare il dashboard
per ogni modifica.

## Creare una chiave di gestione

Segui la [Guida all'Autenticazione](https://runapi.ai/it/docs/guides/authentication.md) per accedere,
therefore apri la pagina Chiavi di gestione e crea una chiave di gestione.
Conservala separatamente dalle chiavi dell'applicazione standard. Inviala come token
bearer solo agli endpoint di Gestione della Piattaforma.

```http
Authorization: Bearer YOUR_MANAGEMENT_KEY
```

Una chiave API standard non può chiamare gli endpoint di gestione di chiavi o guardrail. Una
chiave di gestione valida può comunque ricevere `403 Forbidden` quando il suo proprietario non
dispone più del ruolo account richiesto.

## Elenca le Chiavi API standard

Usa `GET /api/v1/keys` per esaminare le chiavi visibili all'account della chiave di gestione:

```shell
curl "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY"
```

Usa gli identificatori pubblici restituiti per successive richieste di recupero, aggiornamento, revoca o
assegnazione di guardrail. Non dedurre mai l'accesso dal nome di una chiave o da un
token mascherato.

## Crea e ruota una chiave

Crea una chiave applicativa con `POST /api/v1/keys`. Il secret completo viene
restituito solo nella risposta di creazione, quindi salvalo nel tuo gestore di secret
prima di scartare quella risposta. La rotazione deve creare una sostituzione,
distribuirla nell'applicazione, verificare il traffico e quindi revocare la vecchia chiave.

```shell
curl -X POST "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production worker"}'
```

`credit_limit_windows` accetta qualsiasi combinazione di limiti di spesa progressivi `1h`, `1d` e `7d`.
Se una finestra temporale configurata viene esaurita, le chiamate con quella chiave restituiscono
`429 Too Many Requests` fino a quando l'utilizzo non esce dalla finestra temporale.
Invia un oggetto vuoto quando aggiorni una chiave per eliminare tutti i limiti di spesa progressivi.

## Applica guardrail

I Guardrail sono policy di account riutilizzabili per i controlli su modello, provider e
spesa. Gestisci le policy tramite `/api/v1/guardrails`, quindi
utilizza `/api/v1/guardrail_assignments` per associarle o rimuoverle. Considera un'assegnazione
rifiutata come un errore di policy o di proprietà anziché continuare silenziosamente senza il guardrail.

## Gestisci gli errori di gestione

* `401 Unauthorized` indica che la credenziale è assente, malformata,
  revocata o non valida.
* `403 Forbidden` indica che la classe di credenziale o il ruolo
  dell'account non è autorizzato a eseguire l'operazione.
* `404 Not Found` indica che la risorsa richiesta non è visibile
  all'account autenticato.
* `422 Unprocessable Content` indica che uno o più valori inviati
  violano una regola della risorsa.

---

## Altre risorse di RunAPI

- [Home](https://runapi.ai/it/.md)
- [Catalogo dei modelli](https://runapi.ai/it/models.md)
- [Prezzi](https://runapi.ai/it/pricing.md)
- [Fornitori](https://runapi.ai/it/models)
- [Documentazione](https://runapi.ai/it/docs/guides)
- [SDK](https://runapi.ai/it/sdk.md)
- [CLI](https://runapi.ai/it/cli.md)
- [MCP Server](https://runapi.ai/it/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md)
- [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/it/contact.md)
- [Contatti](https://runapi.ai/it/contact.md)
- [Termini](https://runapi.ai/it/terms.md)
- [Privacy](https://runapi.ai/it/privacy.md)
- [Indice del sito per gli agenti](https://runapi.ai/llms.txt)

Contatti: contact@runapi.ai

## Dati strutturati

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/iticon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "TechArticle",
    "headline": "Guida introduttiva",
    "description": "Crea e gestisci chiavi API standard e guardrail con una chiave di gestione RunAPI.",
    "url": "https://runapi.ai/it/docs/guides/platform-management/quickstart",
    "mainEntityOfPage": "https://runapi.ai/it/docs/guides/platform-management/quickstart"
  }
]
```