Guide families Comparacoes de formatos Guias de melhor formato Melhor formato para Guias de conversao
Use-case recommendation

Melhor formato para payloads de resposta de API

JSON e a opcao padrao para a maioria das APIs; Proto se destaca em contratos estritos e servicos de alta performance.

Abrir amostras Abrir manifesto
Recommendation

Recommendation

JSON

JSON tem ferramental universal e continua facil de depurar em fluxos de API.

application/json

Abrir amostras Abrir hub

PROTO

Use Proto para schemas tipados e transporte compacto.

Arquivos: 9

Amostras Hub

GRAPHQL

Use contratos GraphQL quando precisar de flexibilidade de consulta.

Arquivos: 9

Amostras Hub
Related decisions

Related Decisions

Protocol Buffers vs JSON GraphQL Schema vs JSON Melhor formato de dados para APIs Converter ACCESSLOG para JSON
FAQ

FAQ

Qual e a recomendacao de formato padrao para este caso de uso?

JSON e o formato recomendado por padrao aqui.

Como as equipes devem validar esta recomendacao?

Use arquivos de amostra e endpoints de manifesto para testar compatibilidade e comportamento antes do rollout.