> For the complete documentation index, see [llms.txt](https://docs.cuborio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuborio.com/readme.md).

# Panoramica

Documentazione tecnica delle API REST della piattaforma Cuborio.

## Panoramica

Cuborio espone diverse API REST organizzate per dominio funzionale:

| API                                               | Descrizione                                 | Autenticazione |
| ------------------------------------------------- | ------------------------------------------- | -------------- |
| [Utenti](https://docs.cuborio.com/users.md)       | Gestione utenti e profili attributo         | Bearer Token   |
| [Cart](https://cuborio.gitbook.io/cart)           | Catalogo, vendor e ordini del marketplace   | Bearer Token   |
| [SEO](https://cuborio.gitbook.io/seo)             | Metadati SEO delle pagine CMS               | Bearer Token   |
| [DataSpeed](https://cuborio.gitbook.io/dataspeed) | Utenti e destinazioni per il gestionale ERP | Bearer Token   |
| [Booking](https://cuborio.gitbook.io/booking)     | Prenotazioni e biglietteria                 | Bearer Token   |

## Autenticazione

Tutte le API richiedono autenticazione tramite **Bearer Token** OAuth 2.1.

```http
Authorization: Bearer {your-api-token}
```

Per i dettagli sul flusso OAuth, consulta la [guida all'integrazione OAuth](https://docs.cuborio.com/oauth-integration.md).

## Formato risposte

Le API restituiscono risposte in formato JSON. Le risposte paginate seguono la struttura standard Laravel:

```json
{
  "data": [...],
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": "..."
  },
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 15,
    "total": 72
  }
}
```

## Codici di errore comuni

| Codice                     | Significato                 |
| -------------------------- | --------------------------- |
| `401 Unauthorized`         | Token mancante o non valido |
| `403 Forbidden`            | Permessi insufficienti      |
| `404 Not Found`            | Risorsa non trovata         |
| `422 Unprocessable Entity` | Errore di validazione       |
| `429 Too Many Requests`    | Rate limit superato         |
