Innehållsförteckning

Översikt Versionshanteringspolicy Bakåtkompatibilitet Migrering från V1 till V2 Ändringar av slutpunkter Uppdateringar av svarsformat Utfasningstidslinje Icke-bakåtkompatibla ändringar Steg-för-steg-migrering Support & resurser

API-dokumentation

API-migreringsguide – Uppgradering mellan versioner

Planera och genomför smidiga API-versionsuppgraderingar. Förstå icke-bakåtkompatibla ändringar, utfasningstidslinjer och bästa praxis för att migrera mellan Smart Money API-versioner.

Publicerad 21 mars 2026 • 16 min läsning • Avancerad

Migreringsöversikt

Smart Money API utvecklas kontinuerligt med regelbundna uppdateringar. Denna guide täcker versionshantering, icke-bakåtkompatibla ändringar och hur du migrerar din integration utan driftavbrott.

Nyckelprinciper för migrering:

Semantisk versionshantering — MAJOR.MINOR.PATCH-format strikt följt
Långtidsstöd — Tidigare huvudversion stöds i 24+ månader
Utfasningsvarningar — 6 månaders förvarning om alla icke-bakåtkompatibla ändringar
Parallella versioner — Kör v1 och v2 samtidigt under migreringen
Automatiserad testning — Testverktyg för kompatibilitet tillhandahålls

Aktuell status: v1 (nuvarande), v2 (beta, allmän tillgänglighet Q2 2026). v1 stöds till Q1 2028.

Versionshanteringspolicy

Semantisk versionshantering

Versionsformat
API-version: MAJOR.MINOR.PATCH
Exempel: 2.1.3
MAJOR (2) - Icke-bakåtkompatibla ändringar, ny arkitektur
MINOR (1) - Bakåtkompatibla funktioner
PATCH (3) - Bugfixar, säkerhetsuppdateringar

Versionsutgivningscykel

Fas	Varaktighet	Egenskaper
Alpha	2-4 veckor	Stora icke-bakåtkompatibla ändringar, endast testning
Beta	4-8 veckor	Mestadels stabil, community-feedback
Release Candidate	2-4 veckor	Produktionsredo, slutlig polering
Allmän tillgänglighet	24+ månader	Fullt produktionsstöd

Få din API-nyckel på 30 sekunder

Redo att bygga? Hämta en gratis API-nyckel (200 anrop/dag, inget kort behövs) och börja hämta realtidsdata om val, finansiering och on-chain-data.

Hämta din API-nyckel →

Bakåtkompatibilitet

Versionskompatibilitet

Inom en huvudversion kan du alltid uppgradera till nyare delversioner/säkerhetsuppdateringar utan problem:

Slutpunkts-URL:er — Förblir oförändrade
Obligatoriska fält — Tas aldrig bort (endast nya valfria fält läggs till)
HTTP-statuskoder — Bevaras för befintliga scenarier
Svarsstruktur — Kärnfält förblir identiska
Autentisering — Inga ändringar av autentiseringsmekanismer

Graciös utfasning

Utfasningstidslinje
// Månad 1: Meddela utfasning
// Funktion märkt med Deprecation-rubrik
Deprecation: version="2.2", sunset="2026-09-01"
// Månad 3-6: Aktiv utfasningsperiod
// API returnerar varningar men fungerar fortfarande
X-Deprecation-Warning: Denna slutpunkt kommer att tas bort den 2026-09-01
// Månad 6: Slutlig borttagning
// Slutpunkten returnerar 410 Gone
HTTP/1.1 410 Gone

Migrering från V1 till V2

Större ändringar

REST API-omdesign — Renare resursslutpunkter
Svarsformat — Konsekvent inpackning, bättre felhantering
Autentisering — OAuth 2.0-stöd tillagt (API-nycklar fungerar fortfarande)
Begränsning av anrop — Förbättrad granularitet och tydlighet
Webhooks — Omdesignat händelseformat och signering

Slutpunktsmappning

v1-slutpunkt	v2-slutpunkt	Ändringar
GET /whales	GET /v2/whales/tracking	Omorganiserad, tillagt filtrering
GET /funding	GET /v2/derivatives/funding-heatmap	Börsparameter obligatorisk
GET /positions	GET /v2/derivatives/positions	Nya aggregationsalternativ

Ändringar av slutpunkter

Ändringar av begäranparametrar

V1-begäran
// V1: Finansieringsräntor
GET /v1/funding?symbol=BTCUSDT&exchange=binance

V2-begäran
// V2: Samma data, tydligare struktur
GET /v2/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance

Uppdateringar av svarsformat

V1 Response Structure

V1 Format
{
 "status": "success",
 "data": {
 "symbol": "BTCUSDT",
 "funding": 0.0001
  }
}

V2 Response Structure

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

Viktiga skillnader: Ingen status-wrapper, tydligare fältnamn, standardiserad metadata.

Utfasningstidslinje

Planerade utfasningar

Funktion	Meddelad	Utfasningsdatum	Ersättning
/v1/whales	Jan 2026	Jan 2028	/v2/whales/tracking
/v1/funding	Jan 2026	Jan 2028	/v2/derivatives/funding-heatmap
API-nyckel endast auth	Mar 2026	Mar 2027	OAuth 2.0 (nycklar fungerar fortfarande)
Webhook v1-format	Q2 2026	Q2 2027	Webhook v2-format

Brytande ändringar i detalj

Borttagna slutpunkter

/v1/stats — Ersatt av /v2/metrics
/v1/historical — Ersatt av /v2/historical med nya parametrar
/v1/alerts/create — Ersatt av POST /v2/alerts

Parameterändringar

limit — Standard ändrat från 100 till 20 (var explicit!)
timeframe — Nu obligatoriskt för historiska frågor
sort — Format ändrat från "field asc" till "field:asc"

Ändringar i svarsfält

funding → funding_rate
price → mark_price
vol → volume_quote

Steg-för-steg-migration

Fas 1: Planering (Vecka 1-2)

Granska befintlig integration för utfasade funktioner
Mappa v1-slutpunkter till v2-motsvarigheter
Identifiera brytande ändringar som påverkar din kod
Planera teststrategi och tidslinje

Fas 2: Utveckling (Vecka 3-4)

Skapa v2-gren i versionshantering
Uppdatera alla API-slutpunkter till v2-URL:er
Uppdatera hantering av förfrågningar/svar
Kör enhetstester mot sandbox

Fas 3: Testning (Vecka 5-6)

Kör fullständig integrationstest-svit
Testa felscenarier och edge cases
Belastningstestning med v2-slutpunkter
Säkerhetsgranskning av uppdaterad kod

Fas 4: Staging (Vecka 7)

Distribuera v2-kod till staging-miljö
Kör fullständiga acceptanstester
Få godkännande från intressenter
Förbered återställningsplan

Fas 5: Produktion (Vecka 8)

Blue-green-distribution till produktion
Övervaka mätvärden och felhastigheter
Var tillgänglig för supportärenden
Fasa gradvis ut v1-kod

Support & Resurser

Tillgängliga verktyg

Migration Validator — Kontrollera kod för utfasat användande
API Upgrade Checker — Jämför v1 och v2-kompatibilitet
Migration Checklist — PDF med uppgifter och tidslinje
Kodexempel — Före/efter migrationsprover

Få hjälp

E-post: [email protected]
Dokumentation: Se changelog-versioning.html
Discord: Community support channel
Enterprise: Dedikerad migrationsingenjör

Starta din migration idag

Uppgradera till API v2 med omfattande migrationsverktyg, dokumentation och support. Byggt för att stödja migrering utan driftstopp.

Utforska V2

V1 stöds till Jan 2028. Planera din migration idag.