---
title: "Panoramica API REST"
description: "Utilizza AI Glot via HTTP per ispezionare un workspace, i crediti e le traduzioni, scaricare i risultati e automatizzare i glossari con un contratto JSON stabile."
canonical: "https://ai-glot.com/docs/it/api/overview"
updated: "2026-08-12"
---

# Panoramica API REST

L'API REST di AI Glot è la fonte di verità alla base delle integrazioni CLI e MCP.

```text
https://api.ai-glot.com/v1
```

## Cosa può fare v1

- Leggere le funzionalità del workspace, i limiti del piano e gli scope concessi.
- Leggere il saldo dei crediti, le assegnazioni e l'utilizzo nel tempo.
- Elencare e ispezionare le traduzioni esistenti.
- Rinomina, archiviare, ripristinare e scaricare le traduzioni completate.
- Creare, leggere, aggiornare, sostituire ed eliminare i glossari.
- Leggere il catalogo delle lingue supportate.

> **Warning: Nessun caricamento o avvio di traduzione in v1**
>
> L'API non può caricare file, creare batch, avviare traduzioni o spendere crediti. Utilizza l'app web per questi passaggi. Verifica `capabilities.batch_creation` tramite `GET /v1/account` invece di presumere la disponibilità in base al numero di versione.

## Prima richiesta

Crea una chiave negli [Strumenti per sviluppatori](https://app.ai-glot.com/developer), quindi chiama l'endpoint dell'account:

```bash title="cURL"
curl https://api.ai-glot.com/v1/account \
  -H "Authorization: Bearer $AIGLOT_API_KEY"
```

```js title="JavaScript"
const response = await fetch('https://api.ai-glot.com/v1/account', {
  headers: { Authorization: `Bearer ${process.env.AIGLOT_API_KEY}` },
});
const payload = await response.json();
```

```python title="Python"
import os, requests

response = requests.get(
    "https://api.ai-glot.com/v1/account",
    headers={"Authorization": f"Bearer {os.environ['AIGLOT_API_KEY']}"},
)
payload = response.json()
```

Le risposte positive contengono `data` e `request_id`. Le risposte di elenco contengono inoltre `has_more` e `next_cursor`.

## Contratto leggibile da macchina

La specifica aggiornata è disponibile all'indirizzo [api.ai-glot.com/openapi.json](https://api.ai-glot.com/openapi.json). Questa documentazione pubblica lo snapshot utilizzato per renderizzare queste pagine in [/docs/openapi.json](/docs/openapi.json).

**Continua con l'API**

Autenticazione e scope, convenzioni di richiesta e struttura degli errori.

[Autenticazione](/docs/api/authentication)

[Errori](/docs/api/errors)