/domains/register
ثبت دامنه
تمام ابزارهای مورد نیاز برای اتصال نرمافزار، وبسایت یا سامانه ثبت دامنه شما به سرویس Domain123 در این بخش قرار گرفته است.
راهکار آماده برای اتصال WHMCS به Domain123.
تمام سرویسهای Domain123 از طریق REST API در دسترس هستند و پاسخها با فرمت JSON بازگردانده میشوند.
آدرس پایه سرویسhttp://cp.domain123.ir/api/
نسخه API: 2.0
تمام درخواستها باید دارای Header زیر باشند:
Authorization: Bearer YOUR_API_TOKEN
توکن API را میتوانید پس از ورود به پنل کاربری از بخش وبسرویس دریافت کنید.
نمونه درخواست PHP برای ثبت دامنه از طریق REST API:
PHP — domains/register<?php
$token = "dsgflgcxbdsufd98749534nfvfv-gdfigjdfvvf3625f3f6gvkfdkfvnfkvnkfnvnffkgldfjgldfvlmfdvlkfdv";
$url = 'https://cp.domain123.ir/api/domains/register';
$data = array(
'domain_name' => 'example.ir',
'handle_holder' => 'am123-irnic',
'handle' => 'am123-irnic',
'domain_period' => 1,
'Conditions' => 1,
'dns_1' => 'dns1.mrservers.net',
'dns_2' => 'dns2.mrservers.net',
'dns_3' => 'dns3.mrservers.net',
'dns_4' => null,
);
$data_Authorization = array(
'Accept: application/json',
'Authorization: Bearer ' . $token,
);
$fields_tools = http_build_query($data);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $fields_tools);
curl_setopt($ch, CURLOPT_HTTPHEADER, $data_Authorization);
$result = curl_exec($ch);
curl_close($ch);
var_dump($result);
?>
| پارامتر | توضیح |
|---|---|
token |
توکن API |
domain_name |
نام دامنه |
handle_holder |
شناسه ایرنیک مالک دامنه |
handle |
شناسه ایرنیک (در صورت نیاز برابر با handle_holder) |
domain_period |
مدت ثبت (۱ یا ۵ سال) |
Conditions |
پذیرش قوانین (همیشه مقدار ۱) |
dns_1 تا dns_4 |
نیمسرورها (اختیاری) |
در صورت موفقیتآمیز بودن عملیات، پاسخ زیر بازگردانده میشود:
{
"success": true,
"code": 1000
}
در صورت بروز خطا، کدی بهجز ۱۰۰۰ برگشت داده میشود و متن خطا در فیلد message نمایش داده خواهد شد.
{
"error": true,
"message": "...",
"code": ...
}
بهجای فقط ثبت دامنه، تمام APIهای موجود در ماژول رسمی معرفی شدهاند:
/domains/register
ثبت دامنه
/domains/renew
تمدید دامنه
/domains/transfer
انتقال دامنه
/domains/info
اطلاعات دامنه
/domains/dns
مدیریت نیمسرورها
/domains/lock
فعال یا غیرفعال کردن Registrar Lock
/domains/lockStatus
وضعیت Registrar Lock
این Endpointها مستقیماً از ماژول رسمی WHMCS استخراج شدهاند.
بهصورت خلاصه، API از قابلیتهای زیر پشتیبانی میکند: