Τεκμηρίωση API

Οδηγός Δοκιμών API και Περιβάλλον Sandbox

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

Δημοσιεύθηκε στις 21 Μαρτίου 2026 • 14 λεπτά ανάγνωσης • Ανάπτυξη

Επισκόπηση Περιβάλλοντος Sandbox

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

Βασικά χαρακτηριστικά:

  • Πανομοιότυπο με την Παραγωγή — Τα ίδια σημεία τερματισμού, πιστοποίηση, μορφή απάντησης
  • Μόνο Δεδομένα Δοκιμής — Ποτέ δεν επηρεάζει πραγματικούς λογαριασμούς ή ζωντανές αγορές
  • Υψηλά Όρια Ρυθμού — 10,000 αιτήσεις/ώρα έναντι 1,000 στην παραγωγή
  • Ντετερμινιστικές Απαντήσεις — Συνεπή δεδομένα δοκιμής για αναπαραγώγιμη δοκιμή
  • Απομονωμένοι Λογαριασμοί — Χωριστά από τα δεδομένα χρηστών παραγωγής

Καλύτερη Πρακτική: Όλη η ανάπτυξη, δοκιμή και σταδιοποίηση πρέπει να χρησιμοποιούν το περιβάλλον sandbox. Χρησιμοποιήστε την παραγωγή μόνο μετά από πλήρη επικύρωση στο sandbox.

Χαρακτηριστικά Sandbox

Ρεαλιστικά Δεδομένα Δοκιμής

Το sandbox περιέχει ρεαλιστικά δεδομένα αγοράς κρυπτονομισμάτων που δεν αλλάζουν τυχαία:

  • Ιστορικά δεδομένα αγοράς (6 μήνες ρεαλιστικών OHLCV)
  • Σταθερές διευθύνσεις πορτοφολιών φαλαινών με συνεπείς μοτίβα κίνησης
  • Σταθερά ποσοστά χρηματοδότησης που επαναφέρονται κάθε ώρα
  • Ντετερμινιστικά μοτίβα εκκαθάρισης για δοκιμή ακραίων περιπτώσεων

Χαρακτηριστικά Ειδικά για Δοκιμή

Χαρακτηριστικά Δοκιμής
// Ντετερμινιστικά σύμβολα δοκιμής
// Όλα τα σύμβολα δοκιμής ξεκινούν με TEST_
TEST_BTC, TEST_ETH, TEST_SOL, κ.λπ.
// Μαγικές χρονικές σημάνσεις για προσομοίωση σεναρίων
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Επιστρέφει σταθερά δεδομένα δοκιμής
// Εξαναγκασμός σφαλμάτων για δοκιμή χειρισμού εξαιρέσεων
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Εργαλεία Δοκιμής

  • Επαναφορά Δεδομένων — Επαναφορά όλων των λογαριασμών δοκιμής στην αρχική κατάσταση
  • Έλεγχος Χρόνου — Προσομοίωση διαφορετικών συνθηκών αγοράς
  • Εισαγωγή Σφαλμάτων — Εξαναγκασμός συγκεκριμένων σφαλμάτων απάντησης
  • Δοκιμή Ορίων Ρυθμού — Ενεργοποίηση απαντήσεων ορίων ρυθμού
Λάβετε το κλειδί API σας σε 30 δευτερόλεπτα

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

Λάβετε το κλειδί API σας →

Διαπιστευτήρια Δοκιμής

Λήψη Διαπιστευτηρίων API Δοκιμής

Δημιουργήστε έναν λογαριασμό δοκιμής μέσω του πίνακα ελέγχου για να δημιουργήσετε κλειδιά API sandbox:

Μορφή Κλειδιού Δοκιμής
// Τα κλειδιά δοκιμής έχουν διαφορετικό πρόθεμα
sk_test_1234567890abcdef // Κλειδί API δοκιμής
sk_live_1234567890abcdef // Κλειδί API παραγωγής
// Αυτόματα δρομολογείται στο κατάλληλο περιβάλλον
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Δρομολογείται αυτόματα στο sandbox

Προκαθορισμένα Κλειδιά Δοκιμής

Χρησιμοποιήστε αυτά τα δημόσια κλειδιά δοκιμής για γρήγορο πειραματισμό (με όρια ρυθμού):

Κλειδί Δικαιώματα Όριο
sk_test_demo Ανάγνωση όλων 100/ώρα
sk_test_trader Ανάγνωση + ειδοποιήσεις 500/ώρα
sk_test_pro Πλήρης πρόσβαση 5000/ώρα

Ποτέ μην χρησιμοποιείτε κλειδιά δοκιμής στην παραγωγή. Έχουν περιορισμένη λειτουργικότητα και όρια ρυθμού.

Δεδομένα και Στοιχεία Δοκιμής

Διαθέσιμα Σύμβολα Δοκιμής

Το sandbox περιλαμβάνει αυτά τα ζεύγη συναλλαγών δοκιμής με ρεαλιστικά ιστορικά δεδομένα:

Σύμβολα Δοκιμής
// Ζεύγη κρυπτονομισμάτων
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Ερώτηση συμβόλων δοκιμής
GET /v1/symbols?test_only=true

Πορτοφόλια Φαλαινών Δοκιμής

Προκαθορισμένα πορτοφόλια δοκιμής με ντετερμινιστική συμπεριφορά:

  • Πορτοφόλι Συσσώρευσης — Συνεχής αγορά, καλό για δοκιμή ανοδικής τάσης
  • Πορτοφόλι Διανομής — Συνεχής πώληση, καλό για δοκιμή καθοδικής τάσης
  • Πορτοφόλι Ταλαντεύσεων — Εναλλαγή αγοράς/πώλησης, καλό για δοκιμή εύρους
  • Πορτοφόλι Μεταβλητότητας — Τυχαίες μεγάλες συναλλαγές για δοκιμή πίεσης

Επαναφορά Δεδομένων Δοκιμής

Επαναφορά Δεδομένων Δοκιμής
// Επαναφορά όλων των λογαριασμών δοκιμής στην αρχική κατάσταση
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Επαναφορά συγκεκριμένου πόρου
POST /v1/test/reset?resource=whales
// Απάντηση
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Σημεία Λήξης Sandbox

Βασικές URLs

URLs Περιβάλλοντος
// Sandbox (λειτουργία δοκιμής)
https://api-test.smartmoney.io/v1
// Ή χρησιμοποιήστε παράμετρο ερωτήματος
https://api.smartmoneyapi.com/v1?environment=sandbox
// Production (λειτουργία live)
https://api.smartmoneyapi.com/v1

Σημεία Λήξης Μόνο για Sandbox

Σημείο Λήξης Σκοπός
POST /test/reset Επαναφορά δεδομένων δοκιμής σε αρχική κατάσταση
POST /test/inject-error Εισαγωγή συγκεκριμένου σφάλματος για δοκιμή
POST /test/simulate-time Προσομοίωση διαφορετικών συνθηκών αγοράς
GET /test/status Έλεγχος υγείας του περιβάλλοντος sandbox

Προσομοίωση Απαντήσεων

Εισαγωγή Σφαλμάτων Δοκιμής

Εξαναγκασμός συγκεκριμένων σφαλμάτων για δοκιμή χειρισμού εξαιρέσεων:

Εισαγωγή Σφάλματος
// Δοκιμή χειρισμού ορίου ρυθμού
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Δοκιμή μη διαθεσιμότητας υπηρεσίας
GET /v1/whales?X-Test-Error=service_unavailable
// Δοκιμή αποτυχίας πιστοποίησης
GET /v1/whales?X-Test-Error=invalid_key
// Δοκιμή χρονικού ορίου
GET /v1/whales?X-Test-Error=timeout

Διαθέσιμα Σφάλματα Δοκιμής

Κωδικός Σφάλματος Κατάσταση HTTP Περίπτωση Χρήσης
invalid_key 401 Χειρισμός σφάλματος πιστοποίησης
rate_limit_exceeded 429 Δοκιμή λογικής backoff
not_found 404 Χειρισμός ελλείποντων πόρων
service_unavailable 503 Δοκιμή λογικής επανάληψης
timeout 504 Χειρισμός χρονικού ορίου

Όρια Ρυθμού Sandbox

Επίπεδα Ορίου Ρυθμού

Περιβάλλον Όριο/Ώρα Burst Σκοπός
Sandbox 10,000 500/min Ανάπτυξη & δοκιμή
Production Free 1,000 50/min Προσωπικά projects
Production Trader 10,000 400/min Επαγγελματική συναλλαγή
Production Pro 50,000 1000/min Συστήματα υψηλής συχνότητας

Δοκιμή Χειρισμού Ορίου Ρυθμού

Δοκιμή Ορίου Ρυθμού
// Ενεργοποίηση απόκρισης ορίου ρυθμού στο sandbox
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// Η απόκριση περιλαμβάνει κεφαλίδες επανάληψης
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Στρατηγικές Δοκιμής

Δοκιμή Μονάδας με Fixtures

Python Unit Test
import unittest
import requests
class TestSmartMoneyAPI(unittest.TestCase):
def setUp(self):
self.api_key = 'sk_test_demo'
self.base_url = 'https://api-test.smartmoney.io/v1'
def test_whale_tracking(self):
response = requests.get(
f'{self.base_url}/whales/TEST_BTC',
headers={'Authorization': f'Bearer {self.api_key}'}
)
self.assertEqual(response.status_code, 200)
self.assertIn('whales', response.json())

Δοκιμή Ολοκλήρωσης

Δοκιμάστε την πλήρη ροή εργασίας στο sandbox πριν από την ανάπτυξη σε production:

  1. Ανάπτυξη σε staging με διαπιστευτήρια sandbox
  2. Εκτέλεση πλήρους συνόλου δοκιμών στο sandbox
  3. Δοκιμή χειρισμού σφαλμάτων με εισαγωγή σφαλμάτων
  4. Επαλήθευση συμπεριφοράς ορίου ρυθμού
  5. Έλεγχος χρόνου απόκρισης και καθυστέρησης
  6. Μόνο τότε προώθηση σε production

Δοκιμή Φόρτου

Δοκιμή Φόρτου με Apache Bench
// Το sandbox επιτρέπει δοκιμή υψηλού φόρτου
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

Ενσωμάτωση CI/CD

Παράδειγμα GitHub Actions

.github/workflows/test.yml
name: API Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- run: pip install requests pytest
- env:
SMARTMONEY_API_KEY: ${{ secrets.TEST_API_KEY }}
SMARTMONEY_ENV: sandbox
run: pytest tests/

Διαμόρφωση Περιβάλλοντος

Χρησιμοποιήστε μεταβλητές περιβάλλοντος για εναλλαγή μεταξύ sandbox και production:

Ρύθμιση Περιβάλλοντος
// .env.sandbox
SMARTMONEY_API_KEY=sk_test_demo
SMARTMONEY_API_URL=https://api-test.smartmoney.io/v1
SMARTMONEY_ENV=sandbox
// .env.production
SMARTMONEY_API_KEY=sk_live_xxxx
SMARTMONEY_API_URL=https://api.smartmoneyapi.com/v1
SMARTMONEY_ENV=production

Αντιμετώπιση Προβλημάτων

Συχνά Προβλήματα

Το Δοκιμαστικό Κλειδί Δεν Λειτουργεί

Πρόβλημα: Λαμβάνετε 401 Unauthorized με το δοκιμαστικό κλειδί

Λύσεις:

  • Επαληθεύστε ότι το κλειδί ξεκινά με sk_test_ (όχι sk_live_)
  • Ελέγξτε τη μορφή του Authorization header: "Bearer sk_test_xxx"
  • Βεβαιωθείτε ότι χρησιμοποιείτε το δοκιμαστικό endpoint: api-test.smartmoney.io
  • Το δοκιμαστικό κλειδί μπορεί να έχει υπερβεί το όριο χρήσης

Τα Δεδομένα Δεν Επαναφέρονται

Πρόβλημα: Τα δοκιμαστικά δεδομένα δεν επαναφέρονται μετά το POST /test/reset

Λύσεις:

  • Η επαναφορά μπορεί να διαρκέσει έως 30 δευτερόλεπτα
  • Ελέγξτε την κατάσταση του sandbox με GET /test/status
  • Επαληθεύστε ότι χρησιμοποιείτε το σωστό δοκιμαστικό κλειδί API
  • Επικοινωνήστε με την υποστήριξη εάν το πρόβλημα παραμένει

Όρια Χρήσης στο Sandbox

Πρόβλημα: Φτάσατε τα όρια χρήσης στο sandbox (δεν θα έπρεπε να συμβαίνει)

Λύσεις:

  • Επαληθεύστε ότι χρησιμοποιείτε sk_test_pro key (10,000/ώρα)
  • Ελέγξτε το X-RateLimit-Remaining header
  • Περιμένετε για την επόμενη ώρα ή χρησιμοποιήστε διαφορετικό λογαριασμό
  • Επικοινωνήστε με την υποστήριξη για προσωρινή αύξηση του ορίου

Ξεκινήστε τη Δοκιμή Σήμερα

Χρησιμοποιήστε το περιβάλλον sandbox μας για ασφαλή και απομονωμένη ανάπτυξη. Προκαθορισμένα δοκιμαστικά δεδομένα, υψηλά όρια χρήσης και πλήρης συμβατότητα με το production.

Λάβετε Δοκιμαστικά Στοιχεία
Όλα τα πακέτα περιλαμβάνουν πρόσβαση στο sandbox. Χωρίς πρόσθετο κόστος.

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

Οδηγός Εξουσιοδότησης →

Εξουσιοδότηση API και διαχείριση κλειδιών

Αναφορά REST API →

Πλήρης τεκμηρίωση των endpoints του API

Κωδικοί Σφαλμάτων →

Χειρισμός σφαλμάτων και κωδικοί απόκρισης
Ξεκινήστε δωρεάν — 50 κλήσεις/ημέρα, χωρίς κάρτα

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

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