תיעוד API

מדריך לבדיקת API וסביבת Sandbox

שלטו בבדיקות עם סביבת Sandbox מקיפה של Smart Money API. פיתחו ללא סיכון באמצעות נתוני בדיקה מציאותיים, תגובות דטרמיניסטיות ומגבלות קצב נדיבות לניסויים.

פורסם ב-21 במרץ 2026 • 14 דקות קריאה • פיתוח

סקירת סביבת Sandbox

Smart Money API מספקת סביבת Sandbox מלאה לפיתוח ובדיקות. סביבת ה-Sandbox משקפת את מבנה ה-API של סביבת Production אך משתמשת בנתונים סינתטיים ומגבלות קצב נדיבות, המאפשרות לכם לפתח בביטחון לפני המעבר ל-Production.

מאפיינים עיקריים:

  • זהה ל-Production — אותן נקודות קצה, אימות, פורמט תגובה
  • נתוני בדיקה בלבד — לעולם לא משפיע על חשבונות אמיתיים או שווקים חיים
  • מגבלות קצב גבוהות — 10,000 בקשות/שעה לעומת 1,000 ב-Production
  • תגובות דטרמיניסטיות — נתוני בדיקה עקביים לבדיקות שניתן לשחזר
  • חשבונות מבודדים — נפרד מנתוני משתמשים ב-Production

שיטת עבודה מומלצת: כל הפיתוח, הבדיקות וההכנה צריכים להשתמש בסביבת Sandbox. השתמשו ב-Production רק לאחר אימות יסודי ב-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 ל-Production
// מנתב אוטומטית לסביבה המתאימה
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/שעה

לעולם אל תשתמשו במפתחות בדיקה ב-Production. יש להם פונקציונליות מוגבלת ומגבלות קצב.

נתוני בדיקה ונתונים קבועים

סמלי בדיקה זמינים

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

כתובות בסיס

כתובות סביבה
// Sandbox (מצב בדיקה)
https://api-test.smartmoney.io/v1
// או להשתמש בפרמטר שאילתה
https://api.smartmoneyapi.com/v1?environment=sandbox
// Production (מצב חי)
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/דקה פיתוח ובדיקות
Production Free 1,000 50/דקה פרויקטים תחביביים
Production Trader 10,000 400/דקה מסחר מקצועי
Production Pro 50,000 1000/דקה מערכות בתדירות גבוהה

בדיקת טיפול בהגבלת קצב

בדיקת הגבלת קצב
// הפעלת תגובת הגבלת קצב ב-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
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/

תצורת סביבה

השתמש במשתני סביבה כדי לעבור בין סביבת בדיקה לייצור:

הגדרת סביבה
// .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 לא מורשה עם מפתח בדיקה

פתרונות:

  • ודא שהמפתח מתחיל עם sk_test_ (לא sk_live_)
  • בדוק את פורמט כותרת ההרשאה: "Bearer sk_test_xxx"
  • ודא שאתה משתמש בכתובת הבדיקה: api-test.smartmoney.io
  • ייתכן שנחצה מגבלת קצב במפתח הבדיקה

נתונים לא מתאפסים

בעיה: נתוני הבדיקה לא מתאפסים לאחר POST /test/reset

פתרונות:

  • איפוס עשוי לקחת עד 30 שניות להתפשט
  • בדוק את מצב סביבת הבדיקה עם GET /test/status
  • ודא שאתה משתמש במפתח ה-API הנכון לבדיקה
  • צור קשר עם התמיכה אם הבעיה נמשכת

מגבלות קצב בסביבת הבדיקה

בעיה: פוגע במגבלות קצב בסביבת הבדיקה (לא אמור לקרות)

פתרונות:

  • ודא שאתה משתמש במפתח sk_test_pro (10,000 לשעה)
  • בדוק את כותרת X-RateLimit-Remaining
  • המתן לגבול השעה או השתמש בחשבון בדיקה אחר
  • צור קשר עם התמיכה להגדלה זמנית של מגבלת הקצב

התחל לבדוק היום

השתמש בסביבת הבדיקה המקיפה שלנו לפיתוח בטוח ומבודד. נתוני בדיקה דטרמיניסטיים, מגבלות קצב גבוהות ותאימות מלאה לייצור.

קבל אישורי בדיקה
כל התוכניות כוללות גישה לסביבת הבדיקה. ללא עלות נוספת.

משאבים קשורים

מדריך אימות →

אימות API וניהול מפתחות

הפניה ל-REST API →

תיעוד מלא של נקודות קצה API

קודי שגיאה →

טיפול בשגיאות וקודי תגובה
התחל בחינם — 50 קריאות/יום, ללא כרטיס

קבל נתוני זרימת לווייתנים, מימון, עניין פתוח ונתונים על שרשרת משלושה בורסות מ-API אחד. רמה חינמית, ללא כרטיס אשראי, שדרוג בכל עת.

התחל בחינם →
נסה את קונסולת ה-API החיה → (לא נדרש חשבון)