# Effettuare una chiamata API

## Accedi alla documentazione

All'interno del sito web, [accedi alla documentazione](https://docs.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/moduli-integrativi-della-piattaforma/utilizzare-le-api-del-sito/..#documentazione-api) dedicata alle API del sito web.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FjpeU7bMkFhKZfOk2Kc5v%2Fimage.png?alt=media&#x26;token=29ec1f35-3667-4f50-8523-e8a0557d35d4" alt=""><figcaption></figcaption></figure>

Una volta qui, seleziona dall'elenco il tipo di API che vuoi utilizzare in base alle sezioni o ai contenuti del sito.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fkquc91Bm4762wApYGQsA%2Fimage.png?alt=media&#x26;token=0f38e4a0-2aa5-4aba-8386-d25ed2b9f3df" alt=""><figcaption></figcaption></figure>

## Fai la chiamata

Clicca sull'icona di espansione/collaso per aprire il dettaglio della chiamata API (1) e, una volta espanso, sulla voce "Try it out" a destra (2).

<div data-full-width="true"><figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FaPizxcfjtO5h1O2GMZ5M%2Fimage.png?alt=media&#x26;token=89818043-1207-4209-8f6b-11567b7ebb2d" alt=""><figcaption></figcaption></figure> <figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FCy6mL5nfsAqqw1upb4v4%2FApi-Doc-Comune-di-Bugliano-08-26-2025_10_14_AM.png?alt=media&#x26;token=b4a63254-efd7-4f2d-9c6c-6f23ff3cdc12" alt=""><figcaption></figcaption></figure></div>

Compila i parametri di ricerca previsti dalla API (1) e clicca su "Execute" in basso (2).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2FT3TG7UllT6zlCLQcg8yD%2Fimage.png?alt=media&#x26;token=b75d9590-42eb-4d25-9650-54d4cb9a1766" alt=""><figcaption></figcaption></figure>

Se i parametri sono validi, l'API restituirà una risposta con codice 200, come nell'esempio riportato qui sotto:

```json
{
  "items": [
    {
      "id": "609cab52a36fcaecc959671f46e0d1ca",
      "uri": "https://www.comune.bugliano.pi.it/api/openapi/amministrazione/documenti-e-dati/609cab52a36fcaecc959671f46e0d1ca#Modulo-di-richiesta-Bonus-Famiglia",
      "published_at": "2024-03-21T00:00:00+01:00",
      "modified_at": "2024-05-31T11:34:59+02:00",
      "is_public": true,
      "name": "Modulo di richiesta \"Bonus Famiglia\"",
      "has_code": "",
      "protocollo": "",
      "data_protocollazione": null,
      "image": [],
      "document_type": [
        "Modulistica"
      ],
      "topics": [
        {
          "id": "topic_1_economia_e_finanze",
          "uri": "https://www.comune.bugliano.pi.it/api/openapi/argomenti/topic_1_economia_e_finanze#Economia",
          "priority": 1
        }
      ],
      "abstract": "Modulo di richiesta del bonus famiglia",
      "full_description": "",
      "file": null,
      "link": null,
      "attachments": [
        {
          "filename": "File di test 1 (1).pdf",
          "uri": "http://www.comune.bugliano.pi.it/ocmultibinary/download/1454/33281/4/e9eefe956e4b029333899ea9dd948450.pdf/file/File+di+test+1+%281%29.pdf"
        },
        {
          "filename": "File+di+test+1+%5B.pdf",
          "uri": "http://www.comune.bugliano.pi.it/ocmultibinary/download/1454/33281/4/e0580da203969a34b47427de4817b80f.pdf/file/File%2Bdi%2Btest%2B1%2B%255B.pdf"
        },
        {
          "filename": "File+di+test+2+%5D.pdf",
          "uri": "http://www.comune.bugliano.pi.it/ocmultibinary/download/1454/33281/4/9a01048ccdef9d3f98bd7951d3429349.pdf/file/File%2Bdi%2Btest%2B2%2B%255D.pdf"
        },
        {
          "filename": "File+di+test+4.pdf+%5D",
          "uri": "http://www.comune.bugliano.pi.it/ocmultibinary/download/1454/33281/4/cfbbc7452a501415eb912d1affd594a0.pdf+%5D/file/File%2Bdi%2Btest%2B4.pdf%2B%255D"
        }
      ],
      "has_organization": [
        {
          "id": "84418d711e6f2bdc5fb6abea7372237a",
          "uri": "https://www.comune.bugliano.pi.it/api/openapi/amministrazione/uffici/84418d711e6f2bdc5fb6abea7372237a#Ufficio-Tributi",
          "priority": 1
        }
      ],
      "license": [
        "Creative Commons Attribution 4.0 International (CC BY 4.0)"
      ],
      "format": [
        "PDF"
      ],
      "start_time": "2024-03-21T00:00:00+01:00",
      "end_time": null,
      "publication_start_time": "2024-03-21T00:00:00+01:00",
      "publication_end_time": null,
      "expiration_time": null,
      "data_di_firma": null,
      "has_dataset": [],
      "other_information": "",
      "legal_notes": "",
      "reference_doc": [],
      "keyword": [],
      "life_event": [],
      "business_event": [],
      "author": "",
      "tipo_di_risposta": [
        "Orale"
      ],
      "interroganti": [],
      "gruppo_politico": [],
      "data_invio_uffici": null,
      "data_giunta": null,
      "data_risposta_consigliere": null,
      "giorni_interrogazione": 0,
      "data_consiglio": null,
      "giorni_adozione": 0,
      "announcement_type": [],
      "data_di_scadenza_delle_iscrizioni": null,
      "data_di_conclusione": null
    }
  ],
  "self": "https://www.comune.bugliano.pi.it/api/openapi/amministrazione/documenti-e-dati?offset=0&limit=50&searchTerm=Bonus+famiglia&sort=published&order=desc",
  "prev": null,
  "next": null,
  "count": 1
}
```