# Visión general

> Cada herramienta invocable: su función, sus scopes, sus parámetros y un ejemplo en curl, JavaScript y Python.

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

Las herramientas se agrupan por familia, con una página cada una. La referencia se genera a partir del código de la API: no puede desviarse de él, y una herramienta nueva aparece sola.

## Familias de herramientas

| Familia | Herramientas |
| --- | --- |
| [Corpus](/es/docs/api/reference/corpus) | 22 |
| [Lecturas en directo](/es/docs/api/reference/direct) | 9 |
| [Facebook](/es/docs/api/reference/facebook) | 8 |
| [LinkedIn](/es/docs/api/reference/linkedin) | 10 |
| [Upwork](/es/docs/api/reference/upwork) | 19 |
| [Escritura](/es/docs/api/reference/write) | 12 |
| [Acciones](/es/docs/api/reference/act) | 12 |

## Formato de llamada

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

Todas las herramientas se llaman de la misma manera:

- `Authorization: Bearer piq_live_…` y `Content-Type: application/json`.
- Un cuerpo JSON: la entrada de la herramienta. Una herramienta sin parámetros acepta `{}`.
- Una respuesta `200` con la forma `{ "tool": "nom", "output": … }`.
- Un error como `application/problem+json`: consulta [Errores](/es/docs/api/errors).

Los scopes de una clave, lo que limita cada herramienta y los límites están en [Autenticación](/es/docs/api/authentication). La lista actual, con los esquemas de entrada, está en `GET https://piqline.com/api/v1/tools`.

El [documento OpenAPI](https://piqline.com/api/v1/openapi.json) describe las mismas rutas para un generador de clientes.
