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) :
- 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
- Inspectez le schéma de la méthode
Echo:- Entrée
EchoRequest { message: string, count: int32 } - Sortie
EchoResponse { message: string, seq: int64, metadataJson: string }
- Entrée
- Invoquez
Echoavec{"message":"hello-grpc","count":3}:- Unaire : une réponse
{message:"hello-grpc", seq, metadataJson}, statutOK - Streaming serveur
EchoStreamavec la même entrée : 3 framesstream#1/#2/#3
- Unaire : une réponse
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
mapapparaissent comme desmapEntryimbriqués ; les types référencés indirectement sont aussi chargés.
À lire aussi : Pre-URLs d'environnement et configuration TLS dans concepts.