# SDKs

Dois clientes oficiais, sem dependências em tempo de execução: `@wyroapi/sdk` (Node.js 18+, TypeScript, ESM e CommonJS) e `wyro` (Python 3.9+).

```
npm install @wyroapi/sdk
pip install wyro
```

## Node.js / TypeScript

```ts
import { Wyro } from "@wyroapi/sdk";

const wyro = new Wyro({ apiKey: process.env.WYRO_API_KEY });

const post = await wyro.posts.create(
  { text: "…", platforms: ["instagram"], media: [{ url: "https://…/a.jpg" }] },
  { idempotencyKey: crypto.randomUUID() },
);
console.log(post.status, post.preview_url);

for await (const p of wyro.posts.iterate()) console.log(p.id, p.status);
```

## Python

```python
import os, uuid
from wyro import Wyro

wyro = Wyro(api_key=os.environ["WYRO_API_KEY"])

post = wyro.posts.create(
    {"text": "…", "platforms": ["instagram"], "media": [{"url": "https://…/a.jpg"}]},
    idempotency_key=str(uuid.uuid4()),
)
print(post["status"], post["preview_url"])

for p in wyro.posts.iterate():
    print(p["id"], p["status"])
```

## O que incluem

- **Posts**: criar, consultar, listar (com paginação por `next_cursor` ou um iterador), reagendar, cancelar e `bulk(csv, { dryRun })` para um CSV. **Fila**: consultar, definir e próximos horários livres. **Chaves limitadas**: criar, listar e revogar.
- **Contas**: listar e desconectar. **Conectar**: o link para conectar uma conta real.
- **Métricas**: `posts.metrics(id)`, `accounts.metrics(id, período)` e `analytics.overview(período)`.
- **Mídia**: envio direto (até 4 MB) e um helper para o envio pré-assinado de arquivos maiores.
- **Webhooks**: definir, consultar, remover e `verifySignature(secret, timestamp, body, signature)`.
- **Parceiros**: criar, listar, consultar e remover workspaces de clientes, girar a chave e `forClient(externalId)` para agir por um cliente com o seu token de parceiro:

```ts
const client = wyro.forClient("client-123"); // partner token + X-Wyro-External-Id
await client.posts.create({ text: "…", platforms: ["linkedin"] });
```

- **Erros** como uma exceção tipada (`WyroError`) com `code`, `message`, `fix`, `status` e `details` ([catálogo](https://wyroapi.com/pt/docs/erros)).
- **Novas tentativas** em `429` e `5xx`, respeitando o `Retry-After` ([limites](https://wyroapi.com/pt/docs/limites)); criações só são repetidas quando você passa um `idempotencyKey` ([idempotência](https://wyroapi.com/pt/docs/idempotencia)).

## Verificar um webhook

```ts
import { verifySignature } from "@wyroapi/sdk";

const ok = verifySignature(secret, req.headers["x-wyro-timestamp"], rawBody, req.headers["x-wyro-signature"]);
```
