توثيق API

دليل اختبار API وبيئة الساندبوكس

أتقن الاختبار باستخدام بيئة الساندبوكس الشاملة لـ Smart Money API. طور دون مخاطر باستخدام بيانات اختبار واقعية، واستجابات حتمية، وحدود معدل سخية للتجربة.

نُشر في 21 مارس 2026 • 14 دقيقة قراءة • التطوير

نظرة عامة على بيئة الساندبوكس

يوفر Smart Money API بيئة ساندبوكس كاملة الميزات للتطوير والاختبار. تعكس بيئة الساندبوكس بنية API للإنتاج ولكنها تستخدم بيانات اصطناعية وحدود معدل سخية، مما يسمح لك بالتطوير بثقة قبل الانتقال إلى البيئة الحية.

الخصائص الرئيسية:

  • مطابق للإنتاج — نفس نقاط النهاية، المصادقة، تنسيق الاستجابة
  • بيانات الاختبار فقط — لا تؤثر أبدًا على الحسابات الحقيقية أو الأسواق الحية
  • حدود معدل عالية — 10,000 طلب/ساعة مقابل 1,000 في الإنتاج
  • استجابات حتمية — أدوات اختبار متسقة لاختبارات قابلة للتكرار
  • حسابات معزولة — منفصلة عن بيانات المستخدم في الإنتاج

أفضل ممارسة: يجب أن يستخدم كل التطوير والاختبار والمراحل الانتقالية بيئة الساندبوكس. استخدم بيئة الإنتاج فقط بعد التحقق الشامل من الساندبوكس.

ميزات الساندبوكس

بيانات اختبار واقعية

يحتوي الساندبوكس على بيانات سوق للعملات المشفرة واقعية لا تتغير عشوائيًا:

  • بيانات سوق تاريخية (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 في بيئة التجربة:

تنسيق مفتاح الاختبار
// مفاتيح الاختبار لها بادئة مختلفة
sk_test_1234567890abcdef // مفتاح API للاختبار
sk_live_1234567890abcdef // مفتاح API للإنتاج
// يتم التوجيه تلقائيًا إلى البيئة المناسبة
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# يتم التوجيه إلى بيئة التجربة تلقائيًا

مفاتيح الاختبار المكونة مسبقًا

استخدم هذه مفاتيح الاختبار العامة للتجربة السريعة (محدودة المعدل):

المفتاح الأذونات الحد
sk_test_demo قراءة الكل 100/ساعة
sk_test_trader قراءة + تنبيهات 500/ساعة
sk_test_pro وصول كامل 5000/ساعة

لا تستخدم مفاتيح الاختبار في بيئة الإنتاج أبدًا. لديها وظائف محدودة وحدود معدل.

بيانات الاختبار والتركيبات

رموز الاختبار المتاحة

تتضمن بيئة التجربة أزواج التداول الاختبارية هذه مع بيانات تاريخية واقعية:

رموز الاختبار
// أزواج العملات المشفرة
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
}

نقاط نهاية الساندبوكس

عناوين URL الأساسية

عناوين URL للبيئة
// الساندبوكس (وضع الاختبار)
https://api-test.smartmoney.io/v1
// أو استخدم معلمة الاستعلام
https://api.smartmoneyapi.com/v1?environment=sandbox
// الإنتاج (الوضع المباشر)
https://api.smartmoneyapi.com/v1

نقاط النهاية الخاصة بالساندبوكس فقط

نقطة النهاية الغرض
POST /test/reset إعادة تعيين بيانات الاختبار إلى الحالة الأولية
POST /test/inject-error حقن خطأ محدد للاختبار
POST /test/simulate-time محاكاة ظروف السوق المختلفة
GET /test/status فحص صحة بيئة الساندبوكس

محاكاة الاستجابة

حقن أخطاء الاختبار

فرض استجابات خطأ محددة لاختبار معالجة الاستثناءات:

حقن الخطأ
// اختبار معالجة حد المعدل
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 اختبار منطق التراجع
not_found 404 معالجة المورد المفقود
service_unavailable 503 اختبار منطق إعادة المحاولة
timeout 504 معالجة المهلة

حدود معدل الساندبوكس

مستويات حد المعدل

البيئة الحد/الساعة الانفجار الغرض
الساندبوكس 10,000 500/دقيقة التطوير والاختبار
الإنتاج المجاني 1,000 50/دقيقة المشاريع الهواة
إنتاج التاجر 10,000 400/دقيقة التداول الاحترافي
الإنتاج المحترف 50,000 1000/دقيقة أنظمة التردد العالي

اختبار معالجة حد المعدل

اختبار حد المعدل
// تشغيل استجابة حد المعدل في الساندبوكس
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// تتضمن الاستجابة رؤوس إعادة المحاولة
HTTP/1.1 429 طلبات كثيرة جدًا
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

استراتيجيات الاختبار

اختبار الوحدة باستخدام البيانات الثابتة

اختبار وحدة بايثون
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())

اختبار التكامل

اختبار سير العمل الكامل في الساندبوكس قبل النشر للإنتاج:

  1. نشر إلى بيئة الاختبار مع بيانات اعتماد الساندبوكس
  2. تشغيل مجموعة الاختبار الكاملة ضد الساندبوكس
  3. اختبار معالجة الأخطاء مع حقن الأخطاء
  4. التحقق من سلوك تحديد المعدل
  5. فحص وقت الاستجابة وزمن الوصول
  6. ثم فقط الانتقال إلى الإنتاج

اختبار الحمل

اختبار الحمل باستخدام Apache Bench
// يسمح الساندبوكس باختبار الحمل العالي
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 استدعاء/يوم، بدون بطاقة

احصل على بيانات تدفق الحيتان، التمويل، الفائدة المفتوحة والبيانات على السلسلة عبر 3 بورصات من واجهة برمجة تطبيقات واحدة. طبقة مجانية، بدون بطاقة ائتمان، ترقية في أي وقت.

ابدأ مجانًا →
جرب وحدة تحكم API المباشرة → (لا حاجة لحساب)