परिचय और वास्तुकला

MirApi Gateway एक हेडर-संचालित API प्रॉक्सी है जो आपके एप्लिकेशन और किसी भी थर्ड-पार्टी API के बीच स्थित होता है।

यह कैसे काम करता है

आपका ऐप → MirApi Gateway → Upstream API(s)
                ↕
          Rules Engine (हेडर)
          कैश लेयर
          रिट्राय शेड्यूलर
          Circuit Breaker
          PII Masker

अनुरोध चक्र

1. इनग्रेस: आपका अनुरोध proxy.mirapi.io/<प्रदाता>/<पथ> पर आता है।
2. हेडर पार्सिंग: Rules Engine सभी X-* कंट्रोल हेडर पढ़ता है।
3. PCI-DSS Guard: Luhn एल्गोरिदम अनुरोध बॉडी में कार्ड नंबर स्कैन करता है।
4. PII मास्किंग: लॉगिंग से पहले संवेदनशील फ़ील्ड हटा दिए जाते हैं।
5. कैश चेक: यदि X-Cache-TTL सेट है और फ्रेश कैश मौजूद है, तो तुरंत वापस किया जाता है।
6. Upstream कॉल: अनुरोध मूल हेडर के साथ आगे भेजा जाता है।
7. रिट्राय लॉजिक: विफलता पर, X-Retry-Count के आधार पर रिट्राय होता है।
8. कैस्केड रूटिंग: यदि X-Target-Cascade सेट है, तो द्वितीयक लक्ष्य आज़माए जाते हैं।
9. कैश फ़ॉलबैक: यदि सभी रिट्राय विफल हों, तो अंतिम कैश्ड रिस्पॉन्स सर्व होता है।

रिस्पॉन्स हेडर (Response Header)

जब किसी अनुरोध को किसी फ़ॉलबैक तंत्र द्वारा बचाया जाता है, तो MirApi एक रिस्पॉन्स हेडर जोड़ता है:

हेडर	मान	विवरण
X-Rescued	retry, cache, failover, cascade_fallback	यह दर्शाता है कि अनुरोध को कैसे बचाया गया था। केवल बचाव होने पर ही उपस्थित होता है।