ایرر کوڈز اور اسٹیٹس ریفرنس

Smart Money API کے ایرر کوڈز، HTTP اسٹیٹس کوڈز، اور خرابیوں کے ازالے کے اقدامات کی جامع گائیڈ۔ ایرر ردعمل کو سمجھیں اور انضمام کے مسائل کو جلدی حل کریں۔

2xx کامیابی کے کوڈز

کامیابی کے ردعمل سے پتہ چلتا ہے کہ درخواست کامیابی سے پروسیس ہو گئی ہے۔

کوڈ	حالت	مطلب
200	OK	درخواست کامیاب ہوئی۔ ردعمل کے جسم میں درخواست کردہ ڈیٹا شامل ہے۔
201	Created	وسیلہ کامیابی سے بن گیا۔ ردعمل میں نیا وسیلہ شامل ہے۔
204	No Content	درخواست کامیاب ہوئی لیکن واپس کرنے کے لیے کوئی مواد نہیں ہے (مثلاً DELETE)۔

مثال 200 کا ردعمل

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

4xx کلائنٹ ایرر کوڈز

کلائنٹ ایررز سے پتہ چلتا ہے کہ درخواست غلط یا ناجائز تھی۔ اپنی درخواست کو درست کریں اور دوبارہ کوشش کریں۔

کوڈ	حالت	وجہ
400	Bad Request	غلط درخواست نحو۔ کوئری پیرامیٹرز، ہیڈرز، اور درخواست کے جسم کو چیک کریں۔
401	Unauthorized	تصدیق کی سند غائب یا غلط ہے۔ اپنا API کلید یا JWT ٹوکن چیک کریں۔
402	Payment Required	آپ کی سبسکرپشن کی ادائیگی ناکام ہو گئی۔ اپنے اکاؤنٹ میں بلنگ کی معلومات کو اپ ڈیٹ کریں۔
403	Forbidden	تصدیق شدہ لیکن اس وسیلہ کے لیے اجازت نہیں۔ آپ کے منصوبہ میں یہ خصوصیت شامل نہیں ہے۔
404	Not Found	وسیلہ موجود نہیں ہے۔ اینڈ پوائنٹ URL اور پیرامیٹرز کو چیک کریں۔
429	Too Many Requests	ریٹ لیمٹ سے تجاوز کر گیا۔ دوبارہ کوشش کرنے سے پہلے انتظار کریں۔ Retry-After ہیڈر کو چیک کریں۔
422	Unprocessable Entity	تصدیق ناکام ہوئی۔ درخواست کے پیرامیٹرز غلط ہیں یا ضروری فیلڈز غائب ہیں۔

تصدیق کی خرابی کی مثالیں

API کلید غائب (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "تصدیق کی سند فراہم نہیں کی گئی۔",
    "resolution": "اپنی API کلید کو Authorization ہیڈر میں شامل کریں: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

غلط API کلید (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "غلط یا ختم ہونے والی API کلید۔",
    "resolution": "https://smartmoneyapi.com/console سے اپنے کنسول میں نئی API کلید بنائیں"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

ریٹ لیمٹنگ (429)

جب آپ اپنے API کوٹا سے تجاوز کر جاتے ہیں، تو سرور 429 Too Many Requests واپس کرتا ہے۔ ریٹ لیمٹ کی معلومات کے لیے ردعمل کے ہیڈرز کو چیک کریں:

HTTP ہیڈرز

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

ریٹ لیمٹ ایرر کا ردعمل

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "روزانہ API درخواست کی حد (10) سے تجاوز کر گیا۔",
    "resolution": "ٹریڈر ($29/مہینہ، 400 درخواستیں/دن) یا پرو ($79/مہینہ، 4,000 درخواستیں/دن) منصوبہ میں اپ گریڈ کریں۔",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

تصدیق کی خرابیاں (422)

تصدیق کی خرابیاں اس وقت ہوتی ہیں جب آپ کے درخواست کے پیرامیٹرز غلط ہوں یا ضروری فیلڈز غائب ہوں۔

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "درخواست کی تصدیق ناکام ہوئی۔",
    "details": [
      {
        "field": "symbol",
        "error": "غلط ٹریڈنگ جوڑا۔ متوقع فارمیٹ: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "ایک مثبت عدد ہونا چاہیے"
      }
    ],
    "resolution": "تصدیق کی خرابیوں کو درست کریں اور دوبارہ کوشش کریں۔"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx سرور ایرر کوڈز

سرور ایررز ہماری طرف سے ایک مسئلہ کی نشاندہی کرتے ہیں۔ یہ عارضی ہوتے ہیں اور عام طور پر جلدی حل ہو جاتے ہیں۔ ایکسپونینشل بیک آف ریٹری منطق کو نافذ کریں۔

کوڈ	حالت	عمل
500	Internal Error	غیر متوقع سرور ایرر۔ ایکسپونینشل بیک آف کے ساتھ دوبارہ کوشش کریں۔
502	Bad Gateway	عارضی سروس میں خلل۔ چند سیکنڈز کے بعد دوبارہ کوشش کریں۔
503	Service Unavailable	دیکھ بھال یا عارضی آؤٹیج۔ اسٹیٹس پیج چیک کریں۔ Retry-After وقفہ کے بعد دوبارہ کوشش کریں۔
504	Gateway Timeout	درخواست بہت زیادہ وقت لے گئی۔ سرور نے اسے پروسیس کر لیا ہو گا۔ آئیڈیمپوٹینسی چیک کریں۔

سرور ایرر کی مثال (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "دیکھ بھال کی وجہ سے سروس عارضی طور پر دستیاب نہیں ہے۔",
    "resolution": "براہ کرم 5 منٹ کے بعد دوبارہ کوشش کریں۔ اسٹیٹس کو https://status.smartmoneyapi.com پر ٹریک کریں"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

خرابیوں کا ازالہ گائیڈ

401 Unauthorized - غلط API کلید

مسئلہ: API کلید کے باوجود 401 ایررز موصول ہو رہے ہیں۔

حل:

تصدیق کریں کہ API کلید Authorization ہیڈر میں "Bearer" کے ساتھ شامل ہے
چیک کریں کہ آپ کی API کلید ختم یا منسوخ نہیں ہوئی ہے
یقینی بنائیں کہ آپ صحیح کلید استعمال کر رہے ہیں (پروڈکشن، سٹیجنگ، یا ڈویلپمنٹ)
اگر موجودہ کلید کھو گئی ہے تو اپنے کنسول سے نئی API کلید بنائیں

403 Forbidden - خصوصیت دستیاب نہیں

مسئلہ: کچھ اینڈ پوائنٹس پر 403 ایررز آ رہے ہیں۔

حل:

اپنے API ٹیئر کو چیک کریں۔ کچھ اینڈ پوائنٹس کے لیے ٹریڈر یا پرو منصوبہ درکار ہوتا ہے
پریمیم خصوصیات تک رسائی کے لیے /pricing.html پر اپنے منصوبہ کو اپ گریڈ کریں
تصدیق کریں کہ API کلید میں مطلوبہ اسکوپز فعال ہیں
اگر آپ کو لگتا ہے کہ آپ کو رسائی ہونی چاہیے تو سپورٹ سے رابطہ کریں

429 Too Many Requests - ریٹ لیمٹڈ

مسئلہ: 429 ایررز اور ریٹ لیمٹڈ ہو رہا ہے۔

حل:

ایکسپونینشل بیک آف ریٹری منطق کو نافذ کریں (1s، 2s، 4s، وغیرہ انتظار کریں)
اضافی API کالز سے بچنے کے لیے ردعمل کو کیش کریں
REST اینڈ پوائنٹس کو پول کرنے کے بجائے ویب ساکٹ کو ریئل ٹائم ڈیٹا کے لیے استعمال کریں
اعلیٰ کوٹا کے لیے اپنے منصوبہ کو اپ گریڈ کریں (ٹریڈر 1,000/دن، پرو 5,000/دن)
جہاں ممکن ہو متعدد سوالات کو ایک ہی درخواست میں بیچ کریں

400 Bad Request - غلط پیرامیٹرز

مسئلہ: غلط درخواستوں کے ساتھ 400 ایررز موصول ہو رہے ہیں۔

حل:

ضروری اور اختیاری پیرامیٹرز کے لیے API دستاویزات چیک کریں
پیرامیٹرز کی اقسام کی تصدیق کریں (سٹرنگز بمقابلہ نمبرز، ارے بمقابلہ آبجیکٹس)
یقینی بنائیں کہ JSON درست اور صحیح فارمیٹ میں ہے
صحیح اینڈ پوائنٹ URLs کو مناسب پاتھ پیرامیٹرز کے ساتھ استعمال کریں
پیرامیٹر کے ناموں میں ٹائپنگ کی غلطیاں چیک کریں

5xx سرور کی خرابیاں - عارضی تعطل

مسئلہ: 500، 502، 503، یا 504 غلطیاں مل رہی ہیں۔

حل:

سروس کی حالت چیک کریں https://status.smartmoneyapi.com پر
خودکار دوبارہ کوشش کو ایکسپونینشل بیک آف کے ساتھ نافذ کریں (زیادہ سے زیادہ 5-10 کوششیں)
503 غلطیوں کے لیے دوبارہ کوشش کرنے سے پہلے 30-60 سیکنڈ انتظار کریں
دوبارہ کوشش کا وقت طے کرنے کے لیے Retry-After ہیڈر استعمال کریں
واقعے کی اطلاعات کے لیے اسٹیٹس پیج کو سبسکرائب کریں

غلطی کا جواب فارمیٹ

تمام غلطی کے جوابات ایک ہی فارمیٹ پر عمل کرتے ہیں:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "انسانی پڑھنے کے قابل غلطی کا پیغام",
    "details": {...},
    "resolution": "مسئلہ حل کرنے کے اقدامات"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

مزید مدد چاہیے؟

ہماری API دستاویزات چیک کریں یا اپنی غلطی کا کوڈ اور درخواست کی تفصیلات کے ساتھ سپورٹ سے رابطہ کریں۔

API حوالہ

سپورٹ حاصل کریں

سوالات ہیں؟ ہماری دستاویزات چیک کریں یا سپورٹ سے رابطہ کریں۔

کنسول کھولیں