# Vue d’ensemble

> Chaque outil appelable : son rôle, ses scopes, ses paramètres et un exemple en curl, JavaScript et Python.

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

Les outils sont rangés par famille, une page chacune. La référence est générée depuis le code de l’API : elle ne peut pas en dériver, et un outil ajouté y apparaît de lui-même.

## Les familles d’outils

| Famille | Outils |
| --- | --- |
| [Corpus](/fr/docs/api/reference/corpus) | 22 |
| [Lecture en direct](/fr/docs/api/reference/direct) | 9 |
| [Facebook](/fr/docs/api/reference/facebook) | 8 |
| [LinkedIn](/fr/docs/api/reference/linkedin) | 10 |
| [Upwork](/fr/docs/api/reference/upwork) | 19 |
| [Écriture](/fr/docs/api/reference/write) | 12 |
| [Action](/fr/docs/api/reference/act) | 12 |

## Format d’un appel

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

Tous les outils s’appellent de la même façon :

- `Authorization: Bearer piq_live_…` et `Content-Type: application/json`.
- Un corps JSON : l’entrée de l’outil. Un outil sans paramètre accepte `{}`.
- Une réponse `200` de la forme `{ "tool": "nom", "output": … }`.
- Une erreur en `application/problem+json` : voir [Erreurs](/fr/docs/api/errors).

Les scopes d’une clé, ce qui borne chaque outil et les limites sont dans [Authentification](/fr/docs/api/authentication). La liste en direct, avec les schémas d’entrée, se lit par `GET https://piqline.com/api/v1/tools`.

Le [document OpenAPI](https://piqline.com/api/v1/openapi.json) décrit les mêmes routes pour un générateur de client.
