# Panoramica

Documentazione tecnica delle API REST della piattaforma Cuborio.

## Panoramica

Cuborio espone diverse API REST organizzate per dominio funzionale:

| API                                               | Descrizione                                 | Autenticazione |
| ------------------------------------------------- | ------------------------------------------- | -------------- |
| [Utenti](/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](/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         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cuborio.com/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.