مستندات 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
}

نقاط پایانی سندباکس

آدرس‌های پایه

آدرس‌های محیطی
// سندباکس (حالت آزمایشی)
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 Too Many Requests
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. استقرار در محیط staging با اعتبارسنجی سندباکس
  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 Unauthorized با کلید تست

راه‌حل‌ها:

  • بررسی کنید که کلید با sk_test_ شروع شود (نه sk_live_)
  • فرمت هدر Authorization را بررسی کنید: "Bearer sk_test_xxx"
  • مطمئن شوید که از endpoint تست استفاده می‌کنید: api-test.smartmoney.io
  • ممکن است محدودیت نرخ کلید تست بیش از حد باشد

داده‌ها ریست نمی‌شوند

مشکل: داده‌های تست پس از POST /test/reset ریست نمی‌شوند

راه‌حل‌ها:

  • ریست ممکن است تا 30 ثانیه طول بکشد تا اعمال شود
  • وضعیت سندباکس را با GET /test/status بررسی کنید
  • مطمئن شوید که از کلید API تست صحیح استفاده می‌کنید
  • اگر مشکل ادامه داشت با پشتیبانی تماس بگیرید

محدودیت‌های نرخ در سندباکس

مشکل: رسیدن به محدودیت‌های نرخ در سندباکس (نباید اتفاق بیفتد)

راه‌حل‌ها:

  • بررسی کنید که از کلید sk_test_pro استفاده می‌کنید (10,000/ساعت)
  • هدر X-RateLimit-Remaining را بررسی کنید
  • تا مرز ساعت صبر کنید یا از حساب تست دیگری استفاده کنید
  • برای افزایش موقت محدودیت نرخ با پشتیبانی تماس بگیرید

امروز تست را شروع کنید

از محیط سندباکس جامع ما برای توسعه ایمن و ایزوله استفاده کنید. داده‌های تست قطعی، محدودیت‌های نرخ بالا و تطابق کامل ویژگی‌ها با محیط تولید.

دریافت اعتبارنامه‌های تست
تمام پلن‌ها شامل دسترسی به سندباکس هستند. بدون هزینه اضافی.

منابع مرتبط

راهنمای احراز هویت →

احراز هویت API و مدیریت کلیدها

مرجع REST API →

مستندات کامل endpointهای API

کدهای خطا →

مدیریت خطاها و کدهای پاسخ
شروع رایگان — 50 فراخوانی/روز، بدون کارت

داده‌های جریان نهنگ، تأمین مالی، سود باز و داده‌های زنجیره‌ای را از 3 صرافی از یک API دریافت کنید. سطح رایگان، بدون نیاز به کارت اعتباری، هر زمان ارتقا دهید.

شروع رایگان →
کنسول API زنده را امتحان کنید → (نیازی به حساب نیست)