API دستاویزات

API Testing and Sandbox Environment Guide

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
}

سینڈ باکس اینڈ پوائنٹس

بیس URLs

ماحولیاتی URLs
// سینڈ باکس (ٹیسٹ موڈ)
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/min ترقی اور ٹیسٹنگ
پروڈکشن فری 1,000 50/min ہوبی پروجیکٹس
پروڈکشن ٹریڈر 10,000 400/min پیشہ ورانہ ٹریڈنگ
پروڈکشن پرو 50,000 1000/min ہائی فریکوئنسی سسٹمز

ریٹ لیمٹ ہینڈلنگ کی جانچ

ریٹ لیمٹ ٹیسٹنگ
// سینڈ باکس میں ریٹ لیمٹ رسپانس کو ٹرگر کریں
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. سٹیجنگ پر سینڈ باکس کریڈنشلز کے ساتھ ڈپلائی کریں
  2. سینڈ باکس کے خلاف مکمل ٹیسٹ سوٹ چلائیں
  3. ایرر انجیکشن کے ساتھ ایرر ہینڈلنگ کو ٹیسٹ کریں
  4. ریٹ لیمٹنگ رویے کی تصدیق کریں
  5. رسپانس ٹائم اور لیٹنسی چیک کریں
  6. صرف اس کے بعد پروڈکشن پر پروموٹ کریں

لوڈ ٹیسٹنگ

ایپاچی بینچ کے ساتھ لوڈ ٹیسٹ
// سینڈ باکس ہائی لوڈ ٹیسٹنگ کی اجازت دیتا ہے
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD انٹیگریشن

GitHub ایکشنز مثال

.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 سے 3 ایکسچینجز پر لائیو وہیل فلو، فنڈنگ، اوپن انٹرسٹ اور آن چین ڈیٹا حاصل کریں۔ مفت ٹیئر، کوئی کریڈٹ کارڈ نہیں، کسی بھی وقت اپ گریڈ کریں۔

مفت شروع کریں →
لائیو API کنسول آزمائیں → (اکاؤنٹ کی ضرورت نہیں)