# Effettuare una chiamata API

## Accedi alla documentazione

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

<figure><img src="/files/PrIjWl3AatO0LkWRkGGP" 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="/files/hWTZmEVs8VmZeGqNjgWe" 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="/files/cQCKQIhKyelTSAaU8ceE" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ZjhRckufLOkypBcLGIll" alt=""><figcaption></figcaption></figure></div>

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

<figure><img src="/files/Gxzu09tRTpg0GadIzWvi" 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
}
```


---

# 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.opencityitalia.it/manuale-opencity-italia-sito-web-istituzionale-v3/moduli-integrativi-della-piattaforma/utilizzare-le-api-del-sito/effettuare-una-chiamata-api.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.