NiceNIC Domain API v2 دستاویزات اور فوری آغاز
NiceNIC Domain API v2 مارکیٹ اکاؤنٹس اور ری سیلر اکاؤنٹس دونوں کے لیے دستیاب ہے۔ رسائی ترتیب دینے، اپنی پہلی درخواست کی تصدیق کرنے، API رسپانس ماڈل کو سمجھنے اور بائیں نیویگیشن میں صحیح سیکشن میں براہ راست جانے کے لیے اس جائزے کا استعمال کریں۔
مارکیٹ اکاؤنٹ: مارکیٹ اکاؤنٹ کی قیمتوں کے ساتھ API رسائی۔
ری سیلر اکاؤنٹ: موجودہ ری سیلر ٹائر کو تفویض کردہ قیمت کے ساتھ API تک رسائی۔
Compare reseller levels اور pricing →
لائیو ہونے سے پہلے اپنے انٹیگریشن کو آزمائیں۔
پروڈکشن پر جانے سے پہلے اپنے ڈومین API انٹیگریشن کو جانچنے کے لیے NiceNIC API Sandbox استعمال کریں۔ مخصوص جانچ کے ماحول میں تصدیق، API درخواستوں، جوابات کی ہینڈلنگ، اور اپنے ایپلیکیشن ورک فلو کی توثیق کریں۔
API انٹیگریشن کی تیاری کرنے والے ریزیلرز، ہوسٹنگ فراہم کنندگان، ڈویلپرز اور پلیٹ فارمز کے لیے مثالی۔
اپنی پہلی API کال 4 مراحل میں کریں۔
لائیو رجسٹریشنز، تجدید یا منتقلی کو فعال کرنے سے پہلے صرف پڑھنے کی درخواست سے شروع کریں۔ یہ آپ کو بغیر کوئی بامعاوضہ آرڈر دیے تصدیق، درخواست کی فارمیٹنگ اور جواب کو ہینڈل کرنے کی توثیق کرنے دیتا ہے۔
API رسائی فعال کریں
API سیٹنگز کھولیں، اپنا API سیکرٹ بنائیں یا حاصل کریں، اور جہاں قابل اطلاق ہو مجاز سرور IPs ترتیب دیں۔
آتھنٹیکیشن کی تصدیق کریں
فارمیٹ میں Authorization ہیڈر کے ساتھ HTTPS استعمال کریں username:api_secret.
ایک محفوظ ٹیسٹ چلائیں۔
ڈومین کی دستیابی، قیمتوں، اکاؤنٹ بیلنس یا ڈومین کی فہرست سے شروع کریں۔
جواب کو ہینڈل کریں
واپس کردہ کو پڑھیں اور محفوظ کریں code اور msg بامعاوضہ پروڈکشن کارروائیاں فعال کرنے سے پہلے۔
تجویز کردہ پہلی درخواست: ڈومین کی دستیابی
دستیابی اینڈ پوائنٹ ایک درخواست میں متعدد ڈومینز کو کوما کے ساتھ الگ کر کے سپورٹ کرتا ہے۔
اپنی مطلوبہ ورک فلو منتخب کریں
نیچے دیا گیا جائزہ بائیں نیویگیشن کی عکاسی کرتا ہے۔ صحیح ورک فلو کی شناخت کے لیے اسے استعمال کریں، پھر پیرامیٹرز، درخواست کی مثالیں اور جواب کی مثالیں حاصل کرنے کے لیے مخصوص اینڈ پوائنٹ صفحہ کھولیں۔
| سیکشن | اسے اس کے لیے استعمال کریں | دستاویزی افعال |
|---|---|---|
| شروع کرنا | محفوظ طریقے سے منسلک ہوں اور رسپانس ہینڈلنگ کو سمجھیں۔ | API جائزہ، API سینڈ باکس، تصدیق، جوابی کوڈز۔ |
| ڈومین مینجمنٹ | ڈومین کے بنیادی لائف سائیکل کو خودکار بنائیں۔ | دستیابی، ڈومینز کی فہرست، ڈومین کی تفصیلات، رجسٹریشن، تجدید، منتقلی (اندر)، نیم سرورز، رابطے، قیمتیں۔ |
| بدسلوکی اور تعمیل | ان ڈومینز کی نگرانی کریں جنہیں تعمیل کی توجہ کی ضرورت ہے۔ | متاثرہ رپورٹس والے ڈومینز کی فہرست بنائیں اور مشین پڑھنے کے قابل متاثرہ حیثیت، ہولڈ لائف سائیکل، شکایت کی معلومات اور تجویز کردہ کارروائی حاصل کریں۔ |
| ڈی این ایس ریکارڈز | پروگرام کے ذریعے میزبان DNS ریکارڈز کا انتظام کریں۔ | DNS ریکارڈز کی فہرست بنائیں، تخلیق کریں، اپ ڈیٹ کریں اور حذف کریں۔ |
| چائلڈ نیم سرورز | اپنے ڈومین کے تحت نام سرورز کے لیے ہوسٹ / گلو ریکارڈز کا انتظام کریں۔ | چائلڈ نییم سرورز بنائیں، فہرست بنائیں، اپ ڈیٹ کریں اور حذف کریں۔ |
| اکاؤنٹ اور بلنگ | آٹومیشن کو اکاؤنٹ سطح کی جانچوں سے منسلک کریں۔ | اکاؤنٹ بیلنس اور لین دین سے متعلق اکاؤنٹ کی معلومات۔ |
| ڈبلیو ایچ ایم سی ایس اے پی آئی | NiceNIC کو موجودہ WHMCS بلنگ ورک فلو میں ضم کریں۔ | دستیابی، رجسٹریشن، تجدید، منتقلی، ڈومین کی تفصیلات، نیم سرورز، رابطے اور اضافی رجسٹرار ماڈیول کے افعال۔ |
| API اکثر پوچھے گئے سوالات | عام رسائی، سیکیورٹی، جانچ اور ورک فلو کے سوالات حل کریں۔ | اہلیت، اسناد، درخواست ہینڈلنگ، تعاون یافتہ آپریشنز اور انٹیگریشن رہنمائی۔ |
تجویز کردہ پہلا انٹیگریشن سلسلہ
ایک قابل اعتماد پروڈکشن انٹیگریشن کو لائیو کسٹمر آرڈر بھیجنے سے پہلے رسائی اور خریداری کی شرائط کی تصدیق کرنی چاہیے۔
API خفیہ + مجاز IP
صرف پڑھنے کے لیے کنیکٹیویٹی ٹیسٹ
موجودہ اکاؤنٹ سطح کی لاگت معلوم کریں
بامعاوضہ کارروائیوں کے لیے فنڈز کی تصدیق کریں
پروسیس کوڈ + پیغام
رجسٹر / تجدید / منتقل کریں
کامیابی، زیر التواء اور خرابی کے جوابات کو سمجھیں
code: 0 کامیاب جواب
موجودہ اینڈ پوائنٹ مثالیں کامیاب مکمل جوابات کے لیے کوڈ 0 استعمال کرتی ہیں۔
code: 201 — زیر التواء آرڈر
رجسٹریشن اور منتقلی کی دستاویزات کوڈ 201 واپس کر سکتی ہیں جب آرڈر جمع کرایا گیا ہو لیکن حتمی کارروائی ابھی باقی ہو۔
code: 400 درخواست کی خرابی
اینڈ پوائنٹ کی مثالیں درخواست کے پیرامیٹر کی خرابیوں کے لیے کوڈ 400 استعمال کرتی ہیں۔
رجسٹریشن زیر التواء رویہ
ڈومین رجسٹریشن کے لیے، موجودہ دستاویزات میں کہا گیا ہے کہ ایک 201 جواب کا مطلب ہے کہ آرڈر کامیابی سے جمع کر دیا گیا اور فیس کاٹ لی گئی، لیکن حتمی ایکٹیویشن اب بھی رجسٹری کی تصدیق سے مشروط ہے۔ اگر ڈومین ایکٹیویٹ نہیں ہو سکتا، تو رجسٹریشن فیس 24 گھنٹوں کے اندر NiceNIC اکاؤنٹ بیلنس میں واپس کر دی جاتی ہے۔
منتقلی زیر التواء رویہ
ٹرانسفر اینڈ پوائنٹ بھی دستاویز کرتا ہے۔ 201 ایک زیر التواء آرڈر کے طور پر۔ اس لیے آپ کی ایپلیکیشن کو زیر التواء منتقلی کو پروسیسنگ کے لیے قبول شدہ سمجھنا چاہیے، نہ کہ اس بات کے ثبوت کے طور پر کہ منتقلی پہلے ہی مکمل ہو چکی ہے۔
ادائیگی شدہ کارروائیوں سے پہلے قیمت معلوم کریں
NiceNIC کا پرائسنگ اینڈ پوائنٹ ڈومین کے لیے رجسٹریشن، تجدید اور منتقلی کی قیمتیں حاصل کر سکتا ہے۔ دستاویزی type اقدار ہیں register, renew, transfer اور allدستاویزی مدت 1 سے 10 سال ہے، جس میں TLD کے مخصوص استثنات ممکن ہیں۔
رجسٹریشن قیمت کے جوابات بھی ایک واپس کر سکتے ہیں is_premium فلیگ۔ جب آپ کی ایپلیکیشن کو موجودہ اکاؤنٹ سطح کی لاگت جاننے کی ضرورت ہو تو بامعاوضہ درخواست جمع کرانے سے پہلے پرائسنگ اینڈ پوائنٹ استعمال کریں۔
نییم سرورز، DNS ریکارڈز اور چائلڈ نییم سرورز کے درمیان فرق جانیں
| آپریشن | اسے اس وقت استعمال کریں | دستاویزی صلاحیت |
|---|---|---|
| نام سرفرز کو تازہ کریں | آپ کسی ڈومین کو مختلف اتھارٹی نام سرورز کے حوالے کرنا چاہتے ہیں۔ | ڈومین نییم سرور اینڈ پوائنٹ ایک پرائمری، سیکنڈری اور اضافی نییم سرورز کو سپورٹ کرتا ہے، موجودہ صفحہ چھ تک کی حد دستاویز کرتا ہے۔ |
| ڈی این ایس ریکارڈز | آپ NiceNIC DNS ہوسٹنگ استعمال کر رہے ہیں اور زون ریکارڈز کو منظم کرنے کی ضرورت ہے۔ | DNS ریکارڈز کی فہرست بنانے، تخلیق کرنے، اپ ڈیٹ کرنے اور حذف کرنے کے لیے علیحدہ APIs دستاویز کیے گئے ہیں۔ |
| چائلڈ نیم سرورز | آپ کو میزبان / گلو ریکارڈز کی ضرورت ہے جیسے ns1.example.com. |
چائلڈ نییم سرورز بنائیں، فہرست بنائیں، اپ ڈیٹ کریں اور حذف کریں۔ تخلیق اینڈ پوائنٹ کے لیے ضروری ہے کہ نییم سرور کا ہوسٹ نام ڈومین سے مماثل ہو اور یہ ایک IP ایڈریس قبول کرتا ہے۔ |
نہ صرف ڈومین آرڈرز بلکہ پورٹ فولیو کی نگرانی کو خودکار بنائیں
ڈومین API v2 میں پڑھنے کے آپریشنز بھی شامل ہیں جو رجسٹریشن کے بعد مفید ہیں۔ List Domains اینڈ پوائنٹ صفحہ بندی، ترتیب، اسٹیٹس فلٹرنگ اور ہولڈ فلٹرنگ کو سپورٹ کرتا ہے، جبکہ Get Domain Details رجسٹریشن کی تاریخیں، میعاد ختم ہونے کی تاریخیں، نییم سرورز اور رجسٹرنٹ رابطہ کی معلومات واپس کرتا ہے۔
غلط استعمال اور تعمیل کی نگرانی
NiceNIC کا Abuse & Compliance API متاثرہ رپورٹس والے ڈومینز کی فہرست بنا سکتا ہے اور مخصوص ڈومین کے لیے تفصیلی مشین پڑھنے کے قابل خلاصہ واپس کر سکتا ہے۔ تفصیلی abuse اینڈ پوائنٹ چھ ڈومین-سطح کی حیثیت کے جملے دستاویز کرتا ہے: نارمل، زیر جائزہ، زیر التواء کلائنٹ ہولڈ، کلائنٹ ہولڈ، بند اور سرور ہولڈ۔
جواب میں موجودہ اثر، تجویز کردہ اگلا اقدام، ہولڈ کی حالت اور ٹائم لائن، شکایات کی تعداد، شکایات کی تاریخیں، زمرے، DNS-غلط استعمال کی درجہ بندی، ثبوت کی حیثیت اور اطلاع شدہ یو آر ایل شامل ہو سکتے ہیں جہاں قابل اطلاق ہو۔ یہ پلیٹ فارمز اور ری سیلرز کو صرف دستی جائزے پر انحصار کرنے کے بجائے اپنے آپریشنل سسٹمز میں تعمیل کی حیثیت ظاہر کرنے کی اجازت دیتا ہے۔
اپنے سسٹم کے مطابق انٹیگریشن ماڈل منتخب کریں
| آپشن | بہترین برائے | موجودہ دستاویزات کیا فراہم کرتی ہیں |
|---|---|---|
| ڈومین API v2 | کسٹم ویب سائٹس، SaaS پلیٹ فارمز، اندرونی نظام، کسٹم بلنگ یا پروویژننگ ورک فلو۔ | ڈومین، DNS، چائلڈ نییم سرور، اکاؤنٹ اور تعمیل کارروائیوں میں براہ راست HTTPS + JSON انٹیگریشن۔ |
| WHMCS ماڈیول | ہوسٹنگ کمپنیاں اور ریزیلر جو پہلے سے WHMCS استعمال کرتے ہیں۔ | دستیابی، رجسٹریشن، تجدید، منتقلی، ڈومین کی تفصیلات، نیم سرورز، رابطے، لاک/انلاک، EPP کی بازیافت، خرابیوں کا لاگ اور اختیاری ٹیسٹ موڈ۔ |
موجودہ WHMCS دستاویزات میں WHMCS 7.0 یا اس سے اوپر، cURL کے ساتھ PHP 7.0 یا اس سے اوپر، درست NiceNIC API اسناد اور SSL/TLS سپورٹ کو ضروریات کے طور پر درج کیا گیا ہے۔
جب API درخواست ناکام ہو جائے
واپس موصول ہونے والے جواب اور کنفیگریشن کی حالت سے شروع کریں، بجائے اس کے کہ ایک ہی بامعاوضہ عمل کو بار بار دہرائیں۔
تصدیقی یا رسائی کی غلطی
- NiceNIC صارف نام اور API سیکرٹ کی تصدیق کریں۔
- تصدیق کریں کہ Authorization ہیڈر موجود ہے اور درست طریقے سے فارمیٹ کیا گیا ہے۔
- تصدیق کریں کہ API سیکرٹ کو ری سیٹ یا گردش نہیں کیا گیا ہے۔
- اگر IP پابندیاں فعال ہیں تو تصدیق کریں کہ درخواست مجاز آؤٹ باؤنڈ سرور IP سے آ رہی ہے۔
درخواست پیرامیٹر کی خرابی
- درخواست کو مخصوص اینڈ پوائنٹ کے دستاویزی پیرامیٹرز سے موازنہ کریں۔
- مطلوبہ اقدار، فارمیٹس اور کارروائی کے ناموں کی تصدیق کریں۔
- جہاں قابل اطلاق ہو، TLD کے مخصوص رجسٹریشن ادوار یا رابطے کی ضروریات چیک کریں۔
ادا شدہ آپریشن فوری طور پر مکمل نہیں ہوتا
- واپس کردہ کو پڑھیں
codeاورmsg. - کسی کا علاج نہ کریں
201حتمی تکمیل کے طور پر زیر التواء جواب۔ - بامعاوضہ کارروائی دوبارہ کرنے سے پہلے اکاؤنٹ بیلنس اور موجودہ قیمتوں کی تصدیق کریں۔
Need NiceNIC سپورٹ کی ضرورت ہے۔
- درخواست کا ٹائم اسٹیمپ اور API کارروائی ریکارڈ کریں۔
- جہاں قابل اطلاق ہو، شامل ڈومین نام یا آبجیکٹ شامل کریں۔
- واپس کردہ کوڈ اور پیغام شامل کریں۔
- صرف غیر حساس پیرامیٹرز شیئر کریں؛ ٹکٹ میں مکمل API سیکرٹ کبھی پوسٹ نہ کریں۔
ایک محفوظ ٹیسٹ کی درخواست سے شروع کریں۔
API رسائی فعال کریں، تصدیق کی توثیق کریں، دستیابی یا قیمت کی درخواست چلائیں، اور کسٹمر کے سامنے آنے والے بامعاوضہ آپریشنز شروع کرنے سے پہلے اپنی رسپانس ہینڈلنگ کی تصدیق کریں۔






