API हेडर बिल्डर कैसे इस्तेमाल करें
- प्रमाणीकरण का प्रकार चुनें और क्रेडेंशियल डालें।
- Accept / Content-Type वैल्यू चुनें और tracing या idempotency हेडर चालू/बंद करें।
- आपके API को जो भी कस्टम हेडर चाहिए, वे जोड़ें।
- एक्सपोर्ट फ़ॉर्मैट चुनें, ब्लॉक कॉपी करके अपने क्लाइंट में डालें, और नए correlation ID के लिए Regenerate दबाएँ।
API हेडर बिल्डर की खूबियाँ
- Authorization प्रीसेट: Bearer, Basic (अपने आप base64) और API key हेडर
- सही charset पैरामीटर के साथ Accept, Content-Type तथा Accept-Language चुनने की सुविधा
- एक क्लिक में tracing हेडर: X-Request-Id (UUID v4) और W3C traceparent, साथ में Idempotency-Key तथा Cache-Control: no-cache
- कस्टम हेडर, RFC के अनुरूप नाम जाँच के साथ
- एक्सपोर्ट: कच्चे हेडर, cURL, fetch, axios, पूरी HTTP रिक्वेस्ट या JSON ऑब्जेक्ट
- संदर्भ तालिका में सीक्रेट छिपे रहते हैं और कहीं भी नहीं भेजे जाते
API हेडर बिल्डर का उदाहरण
Bearer + JSON + tracing को fetch के रूप में
इनपुट:
Auth: Bearer eyJ… · Accept: application/json · Content-Type: application/json · Tracing: on · Export: JavaScript fetchआउटपुट:
fetch("https://api.example.com/v1/orders", {
method: "POST",
headers: {
"Authorization": "Bearer eyJ…",
"Accept": "application/json",
"Content-Type": "application/json",
"X-Request-Id": "8f1c…",
"traceparent": "00-4bf9…-00f0…-01"
},
});API हेडर बिल्डर के बारे में अक्सर पूछे जाने वाले सवाल
Basic प्रमाणीकरण कैसे एन्कोड होता है?
टूल "username:password" को base64 में एन्कोड करके Authorization: Basic <encoded> बनाता है। base64 एन्क्रिप्शन नहीं है, इसलिए इसे सिर्फ़ HTTPS पर ही इस्तेमाल करें।
X-Request-Id और traceparent किसलिए हैं?
X-Request-Id एक correlation ID है जिसे आप सर्वर लॉग में खोज सकते हैं। traceparent W3C Trace Context हेडर है (version-traceId-spanId-flags) जिसे OpenTelemetry, Datadog और Jaeger जैसे tracing सिस्टम समझते हैं। नए ID के लिए Regenerate दबाएँ।
Idempotency-Key कब भेजना चाहिए?
उन POST रिक्वेस्ट पर जो कुछ बनाती हैं (पेमेंट, ऑर्डर)। टाइमआउट के बाद क्लाइंट दोबारा कोशिश करे तो सर्वर उस key को पहचान लेता है और डुप्लिकेट नहीं बनाता। Stripe, Adyen और कई पेमेंट API इसे ज़रूरी मानते हैं।
क्या मेरे टोकन कहीं संग्रहित या भेजे जाते हैं?
नहीं। सब कुछ आपके ब्राउज़र में ही तैयार होता है। संवेदनशील फ़ील्ड संदर्भ तालिका में छिपे रहते हैं; एक्सपोर्ट में असली वैल्यू होती है ताकि आप उसे अपने क्लाइंट में पेस्ट कर सकें।