Aller au contenu principal

gRPC (vue développeur)

gRPC est un RPC binaire. Cet outil ne vous demande pas de préparer un fichier .proto — dès que le serveur active Server Reflection, le client découvre automatiquement services et méthodes, puis inspecte les champs et les invoque à la demande.

Flux principal​

Comment l'utiliser dans l'interface (trois étapes)​

Avec le service d'exemple qrtest.v1.EchoService (grpc://127.0.0.1:18089, h2c en clair) :

  1. Connectez la requête gRPC (l'url stocke host:port). La reflection tourne automatiquement et donne l'arbre des méthodes :
    • /qrtest.v1.EchoService/Echo — unaire
    • /qrtest.v1.EchoService/EchoStream — streaming serveur
    • /qrtest.v1.EchoService/Collect — streaming client
    • /qrtest.v1.EchoService/Chat — streaming bidirectionnel
  2. Inspectez le schéma de la méthode Echo :
    • Entrée EchoRequest { message: string, count: int32 }
    • Sortie EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Invoquez Echo avec {"message":"hello-grpc","count":3} :
    • Unaire : une réponse {message:"hello-grpc", seq, metadataJson}, statut OK
    • Streaming serveur EchoStream avec la même entrée : 3 frames stream#1/#2/#3

Metadata (headers gRPC)​

Les headers d'authentification/tracing passent en metadata avec des clés en minuscules ; les headers réservés comme grpc-* et content-type sont filtrés.

TLS / mTLS​

Utilisez une Pre-URL grpcs:// et importez des certificats clients dans les réglages.

Pièges (important)​

  • Un statut non-OK est un résultat métier normal, pas un échec de connexion : les timeouts et erreurs métier reviennent comme un code de statut avec une réponse éventuellement vide — ne les traitez pas comme des erreurs de transport. Seul HTTP 4xx indique une vraie erreur.
  • L'outil ne prend en charge que l'unaire et le streaming serveur ; le streaming client / bidirectionnel n'est pas encore invocable (pour le streaming complet dans l'app, l'interface fait foi).
  • Types complexes : les champs map apparaissent comme des mapEntry imbriqués ; les types référencés indirectement sont aussi chargés.

À lire aussi : Pre-URLs d'environnement et configuration TLS dans concepts.