मुख्य कंटेंट तक स्किप करें

gRPC (डेवलपर व्यू)

gRPC बाइनरी RPC है। यह टूल आपसे .proto फ़ाइल तैयार करने की माँग नहीं करता — जब तक सर्वर Server Reflection चालू करता है, क्लाइंट सर्विस और मेथड अपने-आप खोज लेता है, फिर फ़ील्ड देखकर ज़रूरत पर उन्हें कॉल करता है।

कोर फ़्लो​

UI में कैसे उपयोग करें (तीन चरण)​

सैंपल सर्विस qrtest.v1.EchoService (grpc://127.0.0.1:18089, प्लेनटेक्स्ट h2c) के साथ:

  1. gRPC रिक्वेस्ट कनेक्ट करें (url host:port रखता है)। Reflection अपने-आप चलता है और मेथड ट्री देता है:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — bidirectional streaming
  2. Echo मेथड की स्कीम देखें:
    • इनपुट EchoRequest { message: string, count: int32 }
    • आउटपुट EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Echo को {"message":"hello-grpc","count":3} के साथ इनवोक करें:
    • Unary: एक {message:"hello-grpc", seq, metadataJson} रिस्पॉन्स, स्टेटस OK
    • समान इनपुट के साथ Server-streaming EchoStream: 3 फ़्रेम stream#1/#2/#3

मेटाडेटा (gRPC हेडर)​

प्रमाणीकरण/ट्रेसिंग हेडर लोअरकेस्ड कीज़ वाले मेटाडेटा के रूप में पास होते हैं; grpc-* और content-type जैसे आरक्षित हेडर फ़िल्टर हो जाते हैं।

TLS / mTLS​

grpcs:// Pre-URL उपयोग करें और सेटिंग्स में क्लाइंट सर्टिफिकेट इंपोर्ट करें।

सावधानियाँ (महत्वपूर्ण)​

  • ग़ैर-OK स्टेटस एक सामान्य बिज़नेस परिणाम है, कनेक्शन विफलता नहीं: टाइमआउट और बिज़नेस त्रुटियाँ स्टेटस कोड और संभवतः खाली रिस्पॉन्स के साथ लौटती हैं — उन्हें ट्रांसपोर्ट त्रुटि न मानें। केवल HTTP 4xx वास्तविक त्रुटि दर्शाता है।
  • टूल केवल unary और server-streaming समर्थन करता है; client-streaming / bidirectional streaming अभी इनवोक नहीं हो सकते (ऐप के अंदर पूर्ण स्ट्रीमिंग के लिए UI प्रामाणिक है)।
  • जटिल प्रकार: map फ़ील्ड नेस्टेड mapEntry के रूप में दिखते हैं; अप्रत्यक्ष संदर्भित प्रकार भी खिंच आते हैं।

संबंधित: एनवायरनमेंट Pre-URL और TLS कॉन्फ़िगरेशन concepts में।