ETag और If-None-Match
ETag एक HTTP response header है जो डेटा का वर्ज़न टैग रखता है: जब तक resource वही रहता है, टैग भी वही रहता है। क्लाइंट यह टैग If-None-Match header में वापस भेजता है, और अगर सर्वर के पास अब भी वही वर्ज़न है, तो वह बिना body के 304 Not Modified से जवाब देता है। दोनों header RFC 9110 (HTTP Semantics, 2022) में परिभाषित हैं।
सशर्त अनुरोध कैसे काम करता है
टैग "a7f3c9" के साथ एक काल्पनिक आदान-प्रदान:
| चरण | अनुरोध | जवाब |
|---|---|---|
| 1 | GET /v1/funding/rates | 200, ETag: "a7f3c9", JSON body |
| 2 | वही URL, If-None-Match: "a7f3c9" के साथ | 304 Not Modified, बिना body |
| 3 | डेटा अपडेट होने के बाद वही अनुरोध | 200, नया टैग और नया JSON |
मानक के अनुसार 304 जवाब header पर ख़त्म हो जाता है और उसमें body नहीं हो सकती, इसलिए क्लाइंट अपनी कॉपी इस्तेमाल करता है। टैग सर्वर मिलाता है; क्लाइंट बस आख़िरी मिला टैग रखता है और उसी अनुरोध के साथ भेजता है।
import os
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/rates"
cache = {"tag": None, "data": None} # पूरा सेट और उसका टैग
def get_rates():
headers = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
if cache["tag"]:
headers["If-None-Match"] = cache["tag"]
r = requests.get(URL, headers=headers, timeout=10)
if r.status_code == 304:
return cache["data"] # डेटा नहीं बदला, कोटा खर्च नहीं
r.raise_for_status()
cache["tag"] = r.headers.get("ETag")
cache["data"] = r.json()["data"]
return cache["data"]
# कॉइन लोकल में चुनें: coin वाला अनुरोध बिना ETag आता है
btc = [row for row in get_rates() if row["coin"] == "BTC"]
Genesis API में ETag
Genesis API में सिर्फ़ 200 जवाब कॉल गिना जाता है: 304 आपका कोटा खर्च नहीं करता, हालाँकि वह प्रति सेकंड अनुरोध सीमा में गिना जाता है। उसमें body नहीं होती, और 64 KB से छोटे जवाब डाउनलोड मात्रा की सीमा में नहीं गिने जाते। टैग बिना फ़िल्टर वाले पूरे डेटासेट पर मिलता है: coin या फ़िल्टर वाले अनुरोध का जवाब उसी अनुरोध के लिए बनता है और बिना ETag आता है, इसलिए वहाँ फ़िल्टर ही ट्रैफ़िक बचाता है (प्लान और लिमिट)।
काल्पनिक उदाहरण: एक bot हर 60 सेकंड में पूरा funding analytics सारांश /funding/analytics/summary लेता है (Pro और Max प्लान)। यह सेक्शन gzip में लगभग 600 KB का है और इसका टैग क़रीब हर 15 मिनट में बदलता है। 30 दिनों में यह 30 × 24 × 60 = 43,200 अनुरोध होते हैं। If-None-Match के साथ सिर्फ़ 30 × 24 × 4 = 2,880 अनुरोध पूरा सेक्शन डाउनलोड करते हैं; बाक़ी 40,320 बिना body और बिना कोटा कटे 304 के साथ लौटते हैं। ट्रैफ़िक लगभग 26 GB से घटकर 1.7 GB रह जाता है।
यह भी देखें: API polling, HTTP 429, डेटा की ताज़गी, Genesis API का रिस्पॉन्स फ़ॉर्मेट, ETag और एरर, सीमाओं से टकराए बिना API को poll कैसे करें।
सवाल और जवाब
क्या 304 जवाब Genesis API का कोटा खर्च करता है?
नहीं। सिर्फ़ 200 जवाब कोटा खर्च करते हैं; 304 और त्रुटियाँ मुफ़्त हैं, पर वे प्रति सेकंड अनुरोध सीमा में गिने जाते हैं।
अगर जवाब में ETag न हो तो?
meta.freshness_sec से ज़्यादा बार poll न करें और meta.updated_at की तुलना पिछले जवाब से करें: वही मान हो तो snapshot अपडेट नहीं हुआ।