# SDK e ferramentas

> O SDK oficial em TypeScript, as coleções do Postman e do Bruno, o OpenAPI e o portal em markdown (llms.txt) para agentes de IA.


Tudo sai do mesmo OpenAPI, gerado a partir do código da API: o SDK, as coleções e esta documentação.

## SDK de TypeScript

@bydomu/sdk: cliente tipado, paginação com for await, novas tentativas, Idempotency-Key automática e verifyWebhook(). Está pronto e será publicado em breve no npm; enquanto isso, a aba JavaScript de cada endpoint também traz o exemplo com fetch.

npm:

```
npm install @bydomu/sdk
```

TypeScript:

```ts
import { ByDomu } from "@bydomu/sdk";

const bydomu = new ByDomu({ apiKey: process.env.BYDOMU_API_KEY });

const { data: contact } = await bydomu.contacts.get("clx1con001");
for await (const deal of bydomu.deals.list({ status: ["OPEN"] })) {
  console.log(deal.title);
}
```

## Postman, Bruno e OpenAPI

Coleções com todos os endpoints e as variáveis baseUrl e apiKey. Para ensaiar, coloque uma chave de teste em apiKey.

- [Coleção do Postman](https://developers.bydomu.com/bydomu-api.postman_collection.json)
- [Coleção do Bruno](https://developers.bydomu.com/bydomu-api.bruno_collection.json)
- [openapi.json](https://api.bydomu.com/v1/openapi.json)

## llms.txt e markdown

Cada página do portal está em markdown: acrescente .md ao endereço, peça Accept: text/markdown ou use «Copiar para IA». O índice está em [llms.txt](https://developers.bydomu.com/llms.txt) e tudo junto em [llms-full.txt](https://developers.bydomu.com/llms-full.txt).

- [https://developers.bydomu.com/pt/referencia.md](https://developers.bydomu.com/pt/referencia.md)

[Prompts para agentes de código](https://developers.bydomu.com/pt/prompts)