ETag ve If-None-Match
ETag, veri için bir sürüm etiketi taşıyan HTTP yanıt başlığıdır: kaynak aynı kaldıkça etiket de aynı kalır. İstemci etiketi If-None-Match başlığıyla geri gönderir; sunucuda hâlâ o sürüm varsa gövdesiz 304 Not Modified yanıtı verir. Her iki başlık da RFC 9110'da (HTTP Semantics, 2022) tanımlanmıştır.
Koşullu istek nasıl çalışır
"a7f3c9" etiketiyle varsayımsal bir alışveriş:
| Adım | İstek | Yanıt |
|---|---|---|
| 1 | GET /v1/funding/rates | 200, ETag: "a7f3c9", JSON gövde |
| 2 | Aynı URL, If-None-Match: "a7f3c9" ile | 304 Not Modified, gövde yok |
| 3 | Veri güncellendikten sonra aynı istek | 200, yeni etiket ve yeni JSON |
Standarda göre 304 yanıtı başlıklarla biter ve gövde taşıyamaz; istemci kendi kopyasını kullanır. Etiketleri sunucu karşılaştırır; istemci yalnızca aldığı son etiketi saklar ve aynı istekle birlikte gönderir.
import os
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/rates"
cache = {"tag": None, "data": None} # tam veri seti ve etiketi
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"] # veri değişmedi, kota harcanmadı
r.raise_for_status()
cache["tag"] = r.headers.get("ETag")
cache["data"] = r.json()["data"]
return cache["data"]
# coin'i yerelde seçin: coin'li istek ETag'siz gelir
btc = [row for row in get_rates() if row["coin"] == "BTC"]
Genesis API'de ETag
Genesis API'de yalnızca 200 yanıtı çağrı sayılır: 304 kotanızı harcamaz, ancak saniyedeki istek limitine yine dahildir. Gövdesi yoktur ve 64 KB altındaki yanıtlar indirme hacmi limitine sayılmaz. Etiketi filtresiz tam veri setleri taşır: coin veya filtreli bir isteğin yanıtı o istek için oluşturulur ve ETag'siz gelir; bu durumda trafiği filtrenin kendisi azaltır (planlar ve limitler).
Varsayımsal örnek: bir bot, tam fonlama analitiği özetini (/funding/analytics/summary, Pro ve Max planları) her 60 saniyede bir çekiyor. Bölüm gzip'li yaklaşık 600 KB'tır ve etiketi kabaca her 15 dakikada bir değişir. 30 günde bu 30 × 24 × 60 = 43.200 istek eder. If-None-Match ile bunların yalnızca 30 × 24 × 4 = 2.880'i bölümün tamamını indirir; kalan 40.320'si gövdesiz ve kota harcamadan 304 olarak döner. Trafik yaklaşık 26 GB'tan 1,7 GB'a düşer.
Ayrıca bakın: API polling, HTTP 429, veri tazeliği, Genesis API yanıt formatı, ETag ve hatalar, limitlere takılmadan API nasıl sorgulanır.
Sorular ve cevaplar
304 yanıtı Genesis API kotasını harcar mı?
Hayır. Yalnızca 200 yanıtları kotayı harcar; 304 ve hatalar ücretsizdir ama saniyedeki istek limitine yine dahildir.
Yanıtta ETag yoksa ne yapmalı?
meta.freshness_sec süresinden daha sık sorgulamayın ve meta.updated_at değerini önceki yanıtla karşılaştırın: aynı değer, anlık görüntünün güncellenmediği anlamına gelir.