Τεκμηρίωση API

Οδηγός Μετάβασης API — Αναβάθμιση Μεταξύ Εκδόσεων

Σχεδιάστε και εκτελέστε ομαλές αναβαθμίσεις έκδοσης API. Κατανοήστε τις ασύμβατες αλλαγές, τα χρονοδιαγράμματα απόσυρσης και τις βέλτιστες πρακτικές για μετάβαση μεταξύ εκδόσεων του Smart Money API.

Δημοσιεύθηκε στις 21 Μαρτίου 2026 • 16 λεπτά ανάγνωσης • Προχωρημένο

Επισκόπηση Μετάβασης

Το Smart Money API αναπτύσσεται ενεργά με τακτικές ενημερώσεις. Αυτός ο οδηγός καλύπτει τη διαχείριση εκδόσεων, τις ασύμβατες αλλαγές και τον τρόπο μετάβασης της ενσωμάτωσής σας χωρίς διακοπές.

Βασικές αρχές μετάβασης:

  • Σημασιολογική Εκδοτολογία — Η μορφή MAJOR.MINOR.PATCH ακολουθείται αυστηρά
  • Υποστήριξη Μακροπρόθεσμης Περιόδου — Η προηγούμενη κύρια έκδοση υποστηρίζεται για 24+ μήνες
  • Προειδοποιήσεις Απόσυρσης — Προειδοποίηση 6 μηνών για όλες τις ασύμβατες αλλαγές
  • Παράλληλες Εκδόσεις — Εκτελέστε ταυτόχρονα v1 και v2 κατά τη μετάβαση
  • Αυτοματοποιημένη Δοκιμή — Παρέχονται εργαλεία συμβατότητας για σουίτες δοκιμών

Τρέχουσα Κατάσταση: v1 (τρέχουσα), v2 (beta, γενική διαθεσιμότητα Q2 2026). Το v1 υποστηρίζεται μέχρι το Q1 2028.

Πολιτική Εκδόσεων

Σημασιολογική Εκδοτολογία

Μορφή Έκδοσης
Έκδοση API: MAJOR.MINOR.PATCH
Παράδειγμα: 2.1.3
MAJOR (2) - Ασύμβατες αλλαγές, νέα αρχιτεκτονική
MINOR (1) - Χαρακτηριστικά συμβατά με προηγούμενες εκδόσεις
PATCH (3) - Διορθώσεις σφαλμάτων, ενημερώσεις ασφαλείας

Κύκλος Κυκλοφορίας Έκδοσης

Φάση Διάρκεια Χαρακτηριστικά
Alpha 2-4 εβδομάδες Σημαντικές ασύμβατες αλλαγές, μόνο για δοκιμές
Beta 4-8 εβδομάδες Σχεδόν σταθερό, σχόλια από την κοινότητα
Release Candidate 2-4 εβδομάδες Έτοιμο για παραγωγή, τελικές βελτιώσεις
Γενική Διαθεσιμότητα 24+ μήνες Πλήρης υποστήριξη παραγωγής
Αποκτήστε το κλειδί API σας σε 30 δευτερόλεπτα

Έτοιμοι να δημιουργήσετε; Αποκτήστε δωρεάν κλειδί API (100 κλήσεις/ημέρα, χωρίς κάρτα) και αρχίστε να λαμβάνετε ζωντανά δεδομένα φαλαινών, χρηματοδότησης και αλυσίδας.

Αποκτήστε το κλειδί API →

Προς τα Πίσω Συμβατότητα

Συμβατότητα Εκδόσεων

Μέσα σε μια κύρια έκδοση, μπορείτε πάντα να αναβαθμίσετε με ασφάλεια σε νεότερες δευτερεύουσες/διορθωτικές εκδόσεις:

  • URL Σημεία Τερματισμού — Παραμένουν αμετάβλητα
  • Υποχρεωτικά Πεδία — Ποτέ δεν αφαιρούνται (προστίθενται μόνο νέα προαιρετικά πεδία)
  • Κωδικοί Κατάστασης HTTP — Διατηρούνται για υπάρχουσες περιπτώσεις
  • Δομή Απόκρισης — Τα βασικά πεδία παραμένουν πανομοιότυπα
  • Πιστοποίηση — Καμία αλλαγή στους μηχανισμούς πιστοποίησης

Ευγενής Απόσυρση

Χρονοδιάγραμμα Απόσυρσης
// Μήνας 1: Ανακοίνωση απόσυρσης
// Χαρακτηριστικό με επικεφαλίδα Απόσυρσης
Απόσυρση: version="2.2", sunset="2026-09-01"
// Μήνας 3-6: Περίοδος ενεργής απόσυρσης
// Το API επιστρέφει προειδοποιήσεις αλλά εξακολουθεί να λειτουργεί
X-Deprecation-Warning: Αυτό το σημείο τερματισμού θα αφαιρεθεί στις 2026-09-01
// Μήνας 6: Τελική αφαίρεση
// Το σημείο τερματισμού επιστρέφει 410 Gone
HTTP/1.1 410 Gone

Μετάβαση από V1 σε V2

Σημαντικές Αλλαγές

  • Ανασχεδιασμός REST API — Καθαρότερα σημεία τερματισμού πόρων
  • Μορφή Απόκρισης — Συνεπής περιτύλιξη, καλύτερη διαχείριση σφαλμάτων
  • Πιστοποίηση — Προστέθηκε υποστήριξη OAuth 2.0 (τα κλειδιά API εξακολουθούν να λειτουργούν)
  • Περιορισμός Ρυθμού — Βελτιωμένη διακριτικότητα και σαφήνεια
  • Webhooks — Ανασχεδιασμένη μορφή συμβάντων και υπογραφής

Αντιστοίχιση Σημείων Τερματισμού

Σημείο Τερματισμού V1 Σημείο Τερματισμού V2 Αλλαγές
GET /whales GET /v2/whales/tracking Αναδιοργάνωση, προσθήκη φιλτραρίσματος
GET /funding GET /v2/derivatives/funding-heatmap Απαιτούμενη παράμετρος ανταλλαγής
GET /positions GET /v2/derivatives/positions Νέες επιλογές συγκεντρωτικών δεδομένων

Αλλαγές Σημείων Τερματισμού

Αλλαγές Παραμέτρων Αιτήματος

Αίτημα V1
// V1: Ποσοστά χρηματοδότησης
GET /v1/funding?symbol=BTCUSDT&exchange=binance
Αίτημα V2
// V2: Ίδια δεδομένα, πιο καθαρή δομή
GET /v2/derivatives/funding-heatmap?
symbol=BTCUSDT&
exchange=binance

Ενημερώσεις Μορφής Απόκρισης

Δομή Απάντησης V1

Μορφότυπος V1
{
"status": "success",
"data": {
"symbol": "BTCUSDT",
"funding": 0.0001
}
}

Δομή Απάντησης V2

Μορφότυπος V2
{
"data": {
"symbol": "BTCUSDT",
"funding_rate": 0.0001
},
"_meta": {
"request_id": "req_abc123",
"timestamp": 1709980800000
}
}

Κύριες Διαφορές: Χωρίς περιτύλιγμα κατάστασης, πιο ξεκάθαρα ονόματα πεδίων, τυποποιημένα μεταδεδομένα.

Χρονοδιάγραμμα Απαρχής

Προγραμματισμένες Απαρχές

Χαρακτηριστικό Ανακοινώθηκε Ημερομηνία Λήξης Αντικατάσταση
/v1/whales Ιαν 2026 Ιαν 2028 /v2/whales/tracking
/v1/funding Ιαν 2026 Ιαν 2028 /v2/derivatives/funding-heatmap
Εξουσιοδότηση μόνο με κλειδί API Μαρ 2026 Μαρ 2027 OAuth 2.0 (τα κλειδιά λειτουργούν ακόμα)
Μορφότυπος Webhook v1 Q2 2026 Q2 2027 Μορφότυπος Webhook v2

Λεπτομέρειες Αλλαγών

Απομακρυσμένα Σημεία Τερματισμού

  • /v1/stats — Αντικαταστάθηκε από το /v2/metrics
  • /v1/historical — Αντικαταστάθηκε από το /v2/historical με νέες παραμέτρους
  • /v1/alerts/create — Αντικαταστάθηκε από POST /v2/alerts

Αλλαγές Παραμέτρων

  • limit — Η προεπιλογή άλλαξε από 100 σε 20 (να είστε σαφείς!)
  • timeframe — Τώρα απαιτείται σε ιστορικά ερωτήματα
  • sort — Η μορφή άλλαξε από "field asc" σε "field:asc"

Αλλαγές Πεδίων Απάντησης

  • funding → funding_rate
  • price → mark_price
  • vol → volume_quote

Μετεγκατάσταση Βήμα-Βήμα

Φάση 1: Σχεδιασμός (Εβδομάδα 1-2)

  1. Έλεγχος υπάρχουσας ενσωμάτωσης για απαρχαιωμένα χαρακτηριστικά
  2. Αντιστοίχιση σημείων τερματισμού v1 με τα ισοδύναμα v2
  3. Εντοπισμός αλλαγών που επηρεάζουν τον κώδικά σας
  4. Σχεδιασμός στρατηγικής δοκιμών και χρονοδιαγράμματος

Φάση 2: Ανάπτυξη (Εβδομάδα 3-4)

  1. Δημιουργία κλάδου v2 στον έλεγχο έκδοσης
  2. Ενημέρωση όλων των σημείων τερματισμού API σε URLs v2
  3. Ενημέρωση χειρισμού αιτήματος/απάντησης
  4. Εκτέλεση μοναδιαίων δοκιμών στο sandbox

Φάση 3: Δοκιμές (Εβδομάδα 5-6)

  1. Εκτέλεση πλήρους σειράς δοκιμών ενσωμάτωσης
  2. Δοκιμή σενάριων σφαλμάτων και οριακών περιπτώσεων
  3. Δοκιμή φόρτωσης με σημεία τερματισμού v2
  4. Έλεγχος ασφαλείας του ενημερωμένου κώδικα

Φάση 4: Στάδιο (Εβδομάδα 7)

  1. Ανάπτυξη κώδικα v2 σε περιβάλλον στάδιο
  2. Εκτέλεση πλήρων δοκιμών αποδοχής
  3. Λήψη έγκρισης από ενδιαφερόμενους
  4. Προετοιμασία σχεδίου επαναφοράς

Φάση 5: Παραγωγή (Εβδομάδα 8)

  1. Ανάπτυξη blue-green σε παραγωγή
  2. Παρακολούθηση μετρικών και ποσοστών σφαλμάτων
  3. Παραμονή σε ετοιμότητα για ζητήματα υποστήριξης
  4. Σταδιακή κατάργηση κώδικα v1

Υποστήριξη & Πόροι

Διαθέσιμα Εργαλεία

  • Επαληθευτής Μετεγκατάστασης — Έλεγχος κώδικα για απαρχαιωμένη χρήση
  • Ελεγκτής Αναβάθμισης API — Σύγκριση συμβατότητας v1 και v2
  • Λίστα Ελέγχου Μετεγκατάστασης — PDF με εργασίες και χρονοδιάγραμμα
  • Παραδείγματα Κώδικα — Δείγματα πριν και μετά τη μετεγκατάσταση

Λήψη Βοήθειας

  • Email: [email protected]
  • Τεκμηρίωση: Δείτε changelog-versioning.html
  • Discord: Κανάλι υποστήριξης κοινότητας
  • Enterprise: Αφοσιωμένος μηχανικός μετεγκατάστασης

Ξεκινήστε τη Μετεγκατάστασή Σας Σήμερα

Αναβαθμίστε στο API v2 με ολοκληρωμένα εργαλεία μετεγκατάστασης, τεκμηρίωση και υποστήριξη. Σχεδιασμένο για μετεγκατάσταση χωρίς διακοπές.

Εξερευνήστε το V2
Το V1 υποστηρίζεται μέχρι Ιαν 2028. Σχεδιάστε τη μετεγκατάστασή σας σήμερα.

Σχετικοί Πόροι

Ιστορικό Αλλαγών & Διαχείριση Εκδόσεων →

Λεπτομερές ιστορικό εκδόσεων

Αναφορά REST API →

Τεκμηρίωση API V2

Οδηγός Δοκιμών →

Περιβάλλον sandbox για δοκιμές
Ξεκινήστε δωρεάν — 100 κλήσεις/ημέρα, χωρίς κάρτα

Λάβετε ζωντανή ροή φαλαινών, χρηματοδότηση, ανοιχτό ενδιαφέρον και δεδομένα on-chain από 3 ανταλλακτήρια από ένα API. Δωρεάν βαθμίδα, χωρίς πιστωτική κάρτα, αναβάθμιση οποιαδήποτε στιγμή.

Ξεκινήστε δωρεάν →
Δοκιμάστε την ζωντανή κονσόλα API → (χωρίς λογαριασμό)