# Panoramica

> Ogni tool richiamabile: il suo ruolo, i suoi scope, i suoi parametri e un esempio in curl, JavaScript e Python.

Source: https://piqline.com/it/docs/api/reference

I tool sono raggruppati per famiglia, una pagina ciascuna. Il riferimento è generato dal codice dell'API: non può discostarsene, e un nuovo tool compare da solo.

## Famiglie di tool

| Famiglia | Tool |
| --- | --- |
| [Corpus](/it/docs/api/reference/corpus) | 22 |
| [Letture in diretta](/it/docs/api/reference/direct) | 9 |
| [Facebook](/it/docs/api/reference/facebook) | 8 |
| [LinkedIn](/it/docs/api/reference/linkedin) | 10 |
| [Upwork](/it/docs/api/reference/upwork) | 19 |
| [Scrittura](/it/docs/api/reference/write) | 12 |
| [Azioni](/it/docs/api/reference/act) | 12 |

## Formato della chiamata

`POST https://piqline.com/api/v1/tools/{nom}`

Ogni tool si chiama allo stesso modo:

- `Authorization: Bearer piq_live_…` e `Content-Type: application/json`.
- Un corpo JSON: l'input del tool. Un tool senza parametri accetta `{}`.
- Una risposta `200` con la forma `{ "tool": "nom", "output": … }`.
- Un errore come `application/problem+json`: vedi [Errori](/it/docs/api/errors).

Gli scope di una chiave, ciò che limita ogni tool e i limiti si trovano in [Autenticazione](/it/docs/api/authentication). L'elenco in tempo reale, con gli schemi di input, è in `GET https://piqline.com/api/v1/tools`.

Il [documento OpenAPI](https://piqline.com/api/v1/openapi.json) descrive le stesse route per un generatore di client.
