# Visão geral

> Todas as ferramentas chamáveis: função, scopes, parâmetros e um exemplo em curl, JavaScript e Python.

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

As ferramentas são agrupadas por família, uma página para cada. A referência é gerada a partir do código da API: ela não pode divergir dele, e uma nova ferramenta aparece sozinha.

## Famílias de ferramentas

| Família | Ferramentas |
| --- | --- |
| [Corpus](/pt/docs/api/reference/corpus) | 22 |
| [Leituras ao vivo](/pt/docs/api/reference/direct) | 9 |
| [Facebook](/pt/docs/api/reference/facebook) | 8 |
| [LinkedIn](/pt/docs/api/reference/linkedin) | 10 |
| [Upwork](/pt/docs/api/reference/upwork) | 19 |
| [Escrita](/pt/docs/api/reference/write) | 12 |
| [Ações](/pt/docs/api/reference/act) | 12 |

## Formato da chamada

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

Toda ferramenta é chamada da mesma forma:

- `Authorization: Bearer piq_live_…` e `Content-Type: application/json`.
- Um corpo JSON: a entrada da ferramenta. Uma ferramenta sem parâmetros aceita `{}`.
- Uma resposta `200` no formato `{ "tool": "nom", "output": … }`.
- Um erro como `application/problem+json`: veja [Erros](/pt/docs/api/errors).

Os scopes de uma chave, o que limita cada ferramenta e os limites estão em [Autenticação](/pt/docs/api/authentication). A lista atual, com os esquemas de entrada, está em `GET https://piqline.com/api/v1/tools`.

O [documento OpenAPI](https://piqline.com/api/v1/openapi.json) descreve as mesmas rotas para um gerador de clientes.
