Use-case recommendation

Meilleur format pour les payloads de reponse API

JSON est l'option par defaut pour la plupart des APIs; Proto se distingue dans des contrats stricts et des services haute performance.

Test this recommendation JSON samples 22 files Manifest Compare PROTO
Recommendation

Recommendation

JSON

JSON dispose d'un outillage universel et reste facile a deboguer dans les flux API.

application/json

PROTO

Utilisez Proto pour des schemas types et un transport compact.

Fichiers: 9

GRAPHQL

Utilisez des contrats GraphQL quand il faut une flexibilite de requete.

Fichiers: 9

Related decisions

Related Decisions

FAQ

FAQ

Quelle est la recommandation de format par defaut pour ce cas d'usage ?

JSON est le format recommande par defaut ici.

Comment les equipes doivent-elles valider cette recommandation ?

Utilisez des fichiers d'echantillon et des endpoints de manifeste pour tester la compatibilite et le comportement avant le deploiement.