# OpenAPI

A especificação completa da API está em **[/openapi.json](/openapi.json)** (OpenAPI 3.1).

## Usos

- **Postman / Insomnia / Bruno:** importe pela URL `https://placaefipe.com.br/openapi.json`.
- **Gerar cliente tipado:** `npx openapi-typescript https://placaefipe.com.br/openapi.json -o placaefipe.d.ts`
- **GPTs personalizados (ChatGPT):** em *Actions*, importe pela URL e configure a autenticação como *API Key → Bearer*.
- **Agentes e frameworks de IA:** LangChain, LlamaIndex, Vercel AI SDK e afins aceitam OpenAPI para criar ferramentas.

## Endpoints

| Método | Caminho | Descrição | Custo |
|---|---|---|---|
| GET | `/v1/placas/{placa}` | Veículo + FIPE pela placa | 1 crédito se encontrar |
| GET | `/v1/saldo` | Créditos restantes | Grátis |
| POST | `/mcp` | Servidor MCP (JSON-RPC) | Igual às ferramentas |