A brapi mantém contratos previsíveis para integrações humanas e agentic.
/api/v2/... para novas integrações./api/quote/... continua disponível durante a migração para superfícies composable em /api/v2/....Quando a brapi planeja remover ou alterar um endpoint, publica um aviso nesta página e na documentação do endpoint. A resposta do endpoint descontinuado passa a incluir:
Deprecation: trueSunset: <data HTTP em RFC 7231>Link: <https://brapi.dev/docs/versioning>; rel="deprecation"O aviso informa a data de remoção, o motivo e o endpoint substituto. A brapi não envia esses headers antes de uma decisão de produto sobre uma descontinuação específica.
/api/v2/... em novas chamadas.Deprecation e Sunset em cada resposta.Sunset.operationId, schemas e descrições do OpenAPI para gerar chamadas.RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset e Retry-After.A API usa JSON e datas ISO 8601. Os parâmetros usam schemas publicados no
OpenAPI. O campo requestedAt indica o momento da consulta. O campo took
indica a duração da resposta em milissegundos.
Consulte também a documentação da API, o OpenAPI e o guia para agentes.