API انتقال دامنه ای ار
در مقاله های قبل در مورد معرفی و توضیح اولیه وب سرویس عملیات دامنه ir و همچنین وب سرویس ثبت دامنه ir و وب سرویس تمدید دامنه ir توضیح دادیم در این مقاله در مورد وب سرویس انتقال دامنه ir توضیح خواهیم داد.
این درخواست برای انتقال و تمدید دامنه ای انجام میشود که قبلا توسط نماینده درخواست ثبت آن به API ارسال نشده است و کنترل آن هم اکنون بر عهده نماینده دیگری است.
جهت موفقیت آمیز بودن این عملیات نیاز است تا دو مورد زیر رعایت شود:
۱. رابط مالی دامنه برابر شناسه‌ای باشد که نماینده در زمان سفارش نمایندگی دامنه در فرم سفارش وارد کرده است.
۲. رابط نماینده دامنه برابر شناسه وب‌آلفا (ta1822-irnic) باشد.
برای انجام مورد ۲ کافی است تا بعد از تنظیم شناسه کاربر نماینده به عنوان رابط مالی دامنه (توسط صاحب امتیار دامنه)، نماینده از طریق پنل کاربری nic.ir اقدام به تنظیم شناسه وب‌آلفا به عنوان نماینده دامنه نمایید. در صورت انجام این عملیات توسط nic.ir ایمیلی جهت اطلاع صاحب امتیاز برای ایشان ارسال خواهد شد که در آن ایمیل هیچگونه نامی از وب‌آلفا ذکر نخواهد شد.
POST https://api.webalfa.net/v2/domains/transfer
پارامترها
| نام | توضیحات | محدودیت |
|---|---|---|
| name (string) |
نام کامل دامنه | اجباری حداقل طول: ۳ حداکثر طول: ۶۳ |
| period (int) |
مدت تمدید | اجباری حداقل و حداکثر طول: ۱ مقادیر مجاز: ۱ و ۵ |
نمونه درخواست (cURL)
curl -X POST \
https://api.webalfa.net/v2/domains/transfer \
-H ‘content-type: application/json’ \
-H ‘x-api-key: demo-key’ \
-d ‘{
“name”: “example.ir”
“period”: “1”
}’
نمونه پاسخ
{
“success”: “true”
}