API documentation
ثبت دامنه
ثبت نام دامنه فرآیندی است برای رزرو نامی منحصربهفرد در اینترنت به مدت مشخص، معمولاً یک سال یا بیشتر
نوع محتوا
application-json
دستهبندی
domain
عملیات
register
پارامترهای درخواست
| نام پارامتر | نوع | توضیح | نمونه |
|---|---|---|---|
| domain | رشته (3-60) | نام دامنه | example.com |
| year | عدد صحیح (4) | دوره ثبت از ۱ تا ۱۰ سال است، با برخی استثناها برای دامنههای مشخص. | 1 |
| dns1 | سرور | نامسرور اصلی | ns3.my-ndns.com |
| dns2 | سرور | نامسرور ثانویه | ns4.my-ndns.com |
| organization | رشته (1-255) | نام سازمان / شرکت | XXX Ltd. |
| name | رشته (1-16) | نام ثبتکننده | Xiao Ming |
| country | رشته (1-255) | کد کشور، مانند CN | CN |
| state | رشته (1-255) | استان / ایالت | BeiJing |
| city | رشته (1-255) | کد شهر | BJ |
| address | رشته (1-255) | نشانی پستی | BeiJing |
| postcode | عدد صحیح (4-10) | کد پستی | 100000 |
| phone | برای جدا کردن اعداد از «.» استفاده کنید (30) | +کد کشور.کد منطقه و شماره تلفن | +86.13800000000 |
| fax | برای جدا کردن اعداد از «.» استفاده کنید (30) | +کد کشور.کد منطقه و شماره فکس | +86.13800000000 |
| آدرس ایمیل | آدرس ایمیل | [email protected] | |
| contact_source | رشته (1-255) | در صورت تنظیم منبع تماس روی عضو، اطلاعات تماس همانند اطلاعات عضو خواهد بود و سایر اطلاعات تماس نادیده گرفته میشوند. | member |
پارامترهای پاسخ
| نام پارامتر | نوع | توضیح |
|---|---|---|
| domain | رشته | نام دامنه |
| created_date | تاریخ | زمان ثبت دامنه |
| expired_date | تاریخ | تاریخ انقضای دامنه |
نمونه درخواست
{
curl https://api.nicenic.net/v2/?category=domain&action=register&domain={domain}&year={year}&dns1={dns1}&dns2={dns2}&organization={organization}&name={name}&country={country}&state={state}&city={city}&address={address}&postcode={postcode}&phone={phone}&fax={fax}&email={email}&contact_source={contact_source}
-H "Authorization: username:api_secret"
-H "Content-Type: application/json"
}
نتیجه بازگشت
0 OK
پاسخ موفقیتآمیز
{
"code": 0,
"msg" : "success",
"data" : {
"domain":"skwncks.com",
"created_date":"2025-01-21",
"expired_date":"2026-01-21"
}
}
201 در انتظار
در انتظار یاder
{
"code": 201,
"msg" : "Pending order, please wait for the order to be processed!"
}
}
توجه:کد "201" به این معناست که درخواست ثبت با موفقیت ارسال شده و هزینه کسر شده است. فعالسازی نهایی دامنه هنوز منوط به تأیید رجیستری است. اگر دامنه نتواند فعال شود، هزینه ثبت ظرف ۲۴ ساعت به موجودی حساب نمایندگی شما بازپرداخت خواهد شد.
400 درخواست نامعتبر
{
"code": 400,
"msg" : "Request parameter error",
}
