# Riferimento API

Crea integrazioni personalizzate con la REST API di Anomalia. Tutti gli endpoint richiedono autenticazione e restituiscono JSON.

## URL di base

`https://anomalia.so/api/v1` 

## Autenticazione

Ogni richiesta necessita di un token `Bearer` nell'header `Authorization`.

### JWT Supabase (CLI / sessione web)

Ottenuto tramite il flusso di login della CLI. Si rinnova automaticamente. Scade dopo circa 1 ora.

`Authorization: Bearer <jwt_token>`

### API Key (integrazioni)

Chiave a lunga durata generata dalla [dashboard](/app/api-keys). Accesso completo in lettura e scrittura. Inizia con `anomalia_`.

`Authorization: Bearer anomalia_live_...`

## Gestione degli errori

Tutti gli errori restituiscono un body JSON coerente:

`{ "error": "Human-readable message" }`

| Codice | Significato |
| --- | --- |
| `401` | Non autorizzato — token mancante o non valido |
| `403` | Vietato — l'API key non ha accesso a questo brand |
| `404` | Non trovato |
| `405` | Metodo non consentito |
| `500` | Errore interno del server |

## Guida rapida

```
export TOKEN="anomalia_live_..."

# List brands
curl -H "Authorization: Bearer $TOKEN" https://anomalia.so/api/v1/brands

# Get posts
curl -H "Authorization: Bearer $TOKEN" \
  https://anomalia.so/api/v1/brands/my-brand/posts

# Approve a post
curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://anomalia.so/api/v1/brands/my-brand/posts/ID/approve
```

[

Avanti →

Brand

](/it/docs/api/brands)

---
Source: https://www.anomalia.so/it/docs/api