API Dokumentáció

API Migrációs Útmutató — Verziófrissítések

Tervezze meg és hajtsa végre zökkenőmentes API verziófrissítéseket. Ismerje meg a kompatibilitást megszakító változásokat, elavulási idővonalakat és a legjobb gyakorlatokat a Smart Money API verziók közötti migráláshoz.

Közzétéve: 2026. március 21. • 16 perc olvasás • Haladó

Migrációs Áttekintés

A Smart Money API-t folyamatosan fejlesztik rendszeres frissítésekkel. Ez az útmutató a verziókezelést, a kompatibilitást megszakító változásokat és azt, hogyan migrálhatja integrációját leállás nélkül.

A migráció kulcselvei:

  • Szemantikus Verziószámozás — A MAJOR.MINOR.PATCH formátum szigorúan követve
  • Hosszú Távú Támogatás — Az előző főverzió 24+ hónapig támogatott
  • Elavulási Figyelmeztetések — 6 hónapos előzetes értesítés minden kompatibilitást megszakító változásról
  • Párhuzamos Verziók — Futtasson v1 és v2 verziót egyszerre a migráció alatt
  • Automatizált Tesztelés — Tesztkészlet kompatibilitási eszközök biztosítva

Jelenlegi Állapot: v1 (jelenlegi), v2 (béta, általános elérhetőség 2026 Q2). v1 támogatva 2028 Q1-ig.

Verziókezelési Irányelv

Szemantikus Verziószámozás

Verzió Formátum
API Verzió: MAJOR.MINOR.PATCH
Példa: 2.1.3
MAJOR (2) - Kompatibilitást megszakító változások, új architektúra
MINOR (1) - Visszafelé kompatibilis funkciók
PATCH (3) - Hibajavítások, biztonsági frissítések

Verzió Kiadási Ciklus

Fázis Időtartam Jellemzők
Alfa 2-4 hét Gyakori kompatibilitást megszakító változások, csak tesztelésre
Béta 4-8 hét Nagyrészt stabil, közösségi visszajelzés
Kiadási Jelölt 2-4 hét Termelésre kész, utolsó simítások
Általános Elérhetőség 24+ hónap Teljes termelési támogatás
Szerezze meg API kulcsát 30 másodperc alatt

Készen áll a fejlesztésre? Szerezzen egy ingyenes API kulcsot (100 hívás/nap, kártya nélkül), és kezdjen élő bálna-, finanszírozási és láncon lévő adatokat lekérni.

Szerezze meg API kulcsát →

Visszafelé Kompatibilitás

Verzió Kompatibilitás

Egy főverzión belül mindig biztonságosan frissíthet újabb alverziókra/javításokra:

  • Végpont URL-ek — Változatlanok maradnak
  • Kötelező Mezők — Soha nem távolítják el (csak új opcionális mezők kerülnek hozzáadásra)
  • HTTP Állapotkódok — Megmaradnak a meglévő forgatókönyvekhez
  • Válasz Struktúra — A fő mezők változatlanok maradnak
  • Hitelesítés — Nincs változás a hitelesítési mechanizmusokban

Elegáns Elavulás

Elavulási Idővonal
// 1. hónap: Elavulás bejelentése
// Funkció elavulási fejléccel jelölve
Elavulás: version="2.2", sunset="2026-09-01"
// 3-6. hónap: Aktív elavulási időszak
// API figyelmeztetéseket ad vissza, de továbbra is működik
X-Elavulási-Figyelmeztetés: Ez a végpont 2026-09-01-én eltávolításra kerül
// 6. hónap: Végső eltávolítás
// Végpont 410 Gone állapotkódot ad vissza
HTTP/1.1 410 Gone

V1-ről V2-re Migrálás

Főbb Változások

  • REST API Újratervezés — Tisztább erőforrás végpontok
  • Válaszformátum — Konzisztens burkolás, jobb hibakezelés
  • Hitelesítés — OAuth 2.0 támogatás hozzáadva (API kulcsok továbbra is működnek)
  • Sebességkorlátozás — Továbbfejlesztett részletesség és áttekinthetőség
  • Webhookok — Újratervezett eseményformátum és aláírás

Végpont Leképezés

v1 Végpont v2 Végpont Változások
GET /whales GET /v2/whales/tracking Átszervezve, szűrés hozzáadva
GET /funding GET /v2/derivatives/funding-heatmap Kötelező tőzsdeparaméter
GET /positions GET /v2/derivatives/positions Új aggregációs lehetőségek

Végpontváltozások

Kérés Paraméter Változások

V1 Kérés
// V1: Finanszírozási ráták
GET /v1/funding?symbol=BTCUSDT&exchange=binance
V2 Kérés
// V2: Ugyanaz az adat, áttekinthetőbb struktúra
GET /v2/derivatives/funding-heatmap?
symbol=BTCUSDT&
exchange=binance

Válaszformátum Frissítések

V1 Válaszstruktúra

V1 Formátum
{
"status": "success",
"data": {
"symbol": "BTCUSDT",
"funding": 0.0001
}
}

V2 Válaszstruktúra

V2 Formátum
{
"data": {
"symbol": "BTCUSDT",
"funding_rate": 0.0001
},
"_meta": {
"request_id": "req_abc123",
"timestamp": 1709980800000
}
}

Kulcsfontosságú különbségek: Nincs status burkoló, áttekinthetőbb mezőnevek, szabványosított metaadatok.

Elavulási ütemterv

Tervezett elavulások

Funkció Bejelentve Leállítás dátuma Helyettesítés
/v1/whales Jan 2026 Jan 2028 /v2/whales/tracking
/v1/funding Jan 2026 Jan 2028 /v2/derivatives/funding-heatmap
Csak API kulcsos hitelesítés Már 2026 Már 2027 OAuth 2.0 (kulcsok továbbra is működnek)
Webhook v1 formátum 2026. Q2 2027. Q2 Webhook v2 formátum

Kompatibilitástörő változtatások részletei

Eltávolított végpontok

  • /v1/stats — Lecserélve a /v2/metrics-re
  • /v1/historical — Lecserélve a /v2/historical-ra új paraméterekkel
  • /v1/alerts/create — Lecserélve a POST /v2/alerts-re

Paraméterváltoztatások

  • limit — Alapértelmezett érték 100-ról 20-ra változott (legyél explicit!)
  • timeframe — Most már kötelező a histórikus lekérdezéseknél
  • sort — A formátum "field asc"-ről "field:asc"-re változott

Válaszmező-változtatások

  • funding → funding_rate
  • ár → jelölt ár
  • vol → volume_quote

Lépésről lépésre migráció

1. fázis: Tervezés (1-2. hét)

  1. Meglévő integráció auditálása elavult funkciókért
  2. V1 végpontok leképezése V2 megfelelőkre
  3. A kódot érintő változtatások azonosítása
  4. Tesztelési stratégia és idővonal tervezése

2. fázis: Fejlesztés (3-4. hét)

  1. V2 ág létrehozása a verziókezelőben
  2. Minden API végpont frissítése V2 URL-ekre
  3. Kérés/válasz kezelés frissítése
  4. Egységtesztek futtatása sandbox környezetben

3. fázis: Tesztelés (5-6. hét)

  1. Teljes integrációs tesztcsomag futtatása
  2. Hibás forgatókönyvek és szélsőséges esetek tesztelése
  3. Terhelés tesztelés V2 végpontokkal
  4. Frissített kód biztonsági auditálása

4. fázis: Staging (7. hét)

  1. V2 kód üzembe helyezése staging környezetben
  2. Teljes elfogadási tesztek futtatása
  3. Jóváhagyás lekérése az érdekelt felektől
  4. Visszaállítási terv elkészítése

5. fázis: Élesítés (8. hét)

  1. Blue-green üzembe helyezés éles környezetben
  2. Metrikák és hibák figyelése
  3. Készenlétben maradás támogatási problémákra
  4. Fokozatosan kivonni a V1 kódot

Támogatás & Erőforrások

Elérhető eszközök

  • Migráció Érvényesítő — Ellenőrizze a kódot elavult használatért
  • API Frissítés Ellenőrző — Hasonlítsa össze a V1 és V2 kompatibilitását
  • Migráció Ellenőrzőlista — PDF feladatokkal és idővonallal
  • Kód Példák — Migráció előtti/utáni minták

Segítség Kérése

  • Email: [email protected]
  • Dokumentáció: Lásd changelog-versioning.html
  • Discord: Közösségi támogatási csatorna
  • Enterprise: Dedikált migrációs mérnök

Kezdje el a migrációt ma

Frissítsen API V2-re átfogó migrációs eszközökkel, dokumentációval és támogatással. Zero-downtime migráció támogatásával.

Fedezze fel a V2-t
V1 támogatás 2028 januárjáig. Tervezze meg a migrációját ma.

Kapcsolódó Erőforrások

Változásnapló & Verziókezelés →

Részletes verziótörténet

REST API Referencia →

V2 API dokumentáció

Tesztelési Útmutató →

Sandbox környezet teszteléshez
Kezdje ingyen — 100 hívás/nap, kártya nélkül

Kapjon élő whale flow, finanszírozás, nyitott kamat és on-chain adatokat 3 tőzsdéről egy API-ból. Ingyenes szint, nincs hitelkártya, bármikor frissíthet.

Kezdje ingyen →
Próbálja ki az élő API konzolt → (nincs szükség fiókra)