# Umbrella Technology — recursos para LLMs / agentes de código

> Fonte única de verdade da API Rural: o OpenAPI 3 abaixo. Ele é público, sem login.

## API Rural (CAR + conta)

- OpenAPI 3 JSON (canônico): https://umbrellatecnologia.com/docs/openapi-api-rural.v1.json
- Espelho: https://umbrellatecnologia.com/ApiDocs/openapi.json
- Referência humana e playground: https://umbrellatecnologia.com/ApiDocs
- Base da API: https://api.umbrellatecnologia.com
- Auth: Authorization: Bearer {api_key}
- Preços publicados = tabela vigente (R$ 1,00 / 2,30 / 2,60 / 11,00). Contas legadas: ver o campo `precos` em GET /v1/saldo.

## Sandbox — teste sem consumir crédito

Valores reservados que respondem com dados fixos, sem debitar saldo e sem contar nos limites.
Toda resposta de sandbox traz `"sandbox": true`.

- CAR com sucesso: ZZ-0000000-SANDBOXCARBASICO0000000000000000
- CAR inexistente (404): ZZ-0000000-SANDBOXNAOEXISTE0000000000000000
- CAR sem saldo (402): ZZ-0000000-SANDBOXSEMSALDO00000000000000000
- CPF com 2 CARs: 00000000000
- CNPJ com lista truncada: 00000000000000
- Documento inexistente (404): 11111111111

## Como usar no Cursor / Claude Code

```
curl -sL https://umbrellatecnologia.com/docs/openapi-api-rural.v1.json -o openapi-umbrella.json
```

Referencie o arquivo no prompt e peça a implementação dos endpoints de consulta
e/ou de conta (saldo, histórico, limites, recarga).