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.

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.