# API pública de planos do LegalRoute

Esta API somente leitura fornece os planos que o LegalRoute exibe publicamente. Ela não exige autenticação.

## Endpoint

`GET https://legalroute.com.br/platform-api/api/v1/public/plans`

A resposta usa `application/json` e contém uma lista ordenada de planos ativos e visíveis no site.

```bash
curl --fail --silent --show-error \
  -H 'Accept: application/json' \
  https://legalroute.com.br/platform-api/api/v1/public/plans
```

## Campos importantes

- `price_monthly`: preço mensal em BRL, serializado como string decimal.
- `price_annual`: valor mensal equivalente na contratação anual, serializado como string decimal.
- `price_monthly` ou `price_annual` com valor `null`: preço sob consulta; não presuma zero.
- `features`: lista descritiva de recursos ou `null`.
- `limits`: mapa extensível de limites e capacidades. Clientes devem ignorar chaves desconhecidas.
- `trial_days`: quantidade de dias de teste; zero indica ausência de período de teste.
- `show_on_site`: indica que o plano pode ser exibido publicamente.

O schema completo está na [especificação OpenAPI](https://legalroute.com.br/.well-known/openapi/public-plans.json).

## Erros e limites de uso

- `200`: consulta concluída.
- `429`: excesso de requisições. Respeite `Retry-After`, quando presente, e use retentativa com espera progressiva.
- `5xx`: indisponibilidade temporária. Não reutilize indefinidamente uma resposta antiga como se fosse atual.

O serviço pode aplicar limites de requisição sem publicar uma cota fixa. Armazene respostas por um intervalo curto e evite consultas repetidas sem necessidade.

## Autenticação

Este endpoint não usa chave de API, OAuth ou token. As APIs operacionais do produto não fazem parte desta documentação pública.