مدیریت دامنه

توضیحات

از این پایانه ها می توانید دامنه های خود را مدیریت کنید؛ همان کارهایی که در پنل کاربری پارسدِو انجام می شود.
در همه پایانه ها دامنه با نام آن (domain) مشخص می شود و باید یکی از سرویس های دامنه حساب شما باشد.
در درخواست های GET و DELETE می توانید پارامترها را در query string یا بدنه JSON بفرستید.

پاسخ درست به شکل {"status": "success", "message": "...", "data": {...}} است.
پاسخ خطا به شکل زیر است. خطای ورودی و درخواست کد 400 و خطای رجیستری کد 500 دارد:

{
    "status": "error",
    "code": 1204,
    "message": "دامنه مورد نظر یافت نشد"
}

فهرست کدها در صفحه کدهای خطا آمده است. همه تغییرها و هر دریافت کد انتقال در گزارش حساب شما ثبت می شود.

فهرست دامنه ها

GET https://parsdev.com/api/v1/domain/list?page=1&per_page=50&search=parsdev

{
    "status": "success",
    "data": [
        {
            "id": "k7pvjiM4ZnG",
            "domain": "example.com",
            "status": "active",
            "service_start": "2025-01-10T00:00:00+03:30",
            "service_end": "2027-01-10T00:00:00+03:30",
            "registrar": "KeySystem"
        }
    ],
    "meta": {"page": 1, "per_page": 50, "total": 1, "last_page": 1}
}

اطلاعات دامنه

GET https://parsdev.com/api/v1/domain/show?domain=example.com

{
    "status": "success",
    "data": {
        "id": "k7pvjiM4ZnG",
        "domain": "example.com",
        "status": "active",
        "service_start": "2025-01-10T00:00:00+03:30",
        "service_end": "2027-01-10T00:00:00+03:30",
        "registrar": "KeySystem",
        "registry": {
            "paid_until": "2027-01-10T00:00:00+00:00",
            "renewal_date": "2027-01-10T00:00:00+00:00",
            "registry_status": "ACTIVE",
            "locked": true,
            "contact": "P-NNL504",
            "nameservers": ["ns1.parsdev.net", "ns2.parsdev.net", "", ""]
        },
        "registry_error": null,
        "features": {
            "nameservers": true,
            "lock": true,
            "auth_code": true,
            "contacts": true,
            "child_nameservers": true
        }
    }
}

نیم سرور

دریافت نیم سرورها:

GET https://parsdev.com/api/v1/domain/nameservers?domain=example.com

تغییر نیم سرورها:

PUT https://parsdev.com/api/v1/domain/nameservers

{
    "domain": "example.com",
    "ns1": "ns1.parsdev.net",
    "ns2": "ns2.parsdev.net"
}

{
    "status": "success",
    "message": "نیم سرورهای دامنه با موفقیت به روز شد",
    "data": {
        "domain": "example.com",
        "nameservers": ["ns1.parsdev.net", "ns2.parsdev.net", "", ""]
    }
}

قفل دامنه

PUT https://parsdev.com/api/v1/domain/lock

{
    "domain": "example.com",
    "locked": false
}

کد انتقال

GET https://parsdev.com/api/v1/domain/auth-code?domain=example.com

{
    "status": "success",
    "data": {
        "domain": "example.com",
        "auth_code": "Xy#9981abc"
    }
}

مشخصات تماس

دامنه جدید روی هندل شرکت پارسدِو ثبت می شود. برای ثبت مشخصات مشتری، یک هندل بسازید و آن را روی دامنه تنظیم کنید.
رجیستری هندل با کشور ایران یا شماره تلفن 98+ را نمی پذیرد. همه فیلدها باید با حروف انگلیسی باشند.

مشخصات تماس فعلی دامنه:

GET https://parsdev.com/api/v1/domain/contact?domain=example.com

{
    "status": "success",
    "data": {
        "domain": "example.com",
        "contact": {
            "handle": "P-ABC123",
            "firstname": "Ali",
            "lastname": "Salehi",
            "company": "",
            "street": "No 10, Main Street",
            "city": "Istanbul",
            "state": "",
            "zip": "34000",
            "country": "TR",
            "phone": "+90.5321234567",
            "email": "info@example.com"
        }
    }
}

فهرست هندل های شما در رجیسترار این دامنه:

GET https://parsdev.com/api/v1/domain/handles?domain=example.com

ساخت هندل جدید:

POST https://parsdev.com/api/v1/domain/handles

{
    "domain": "example.com",
    "firstname": "Ali",
    "lastname": "Salehi",
    "street": "No 10, Main Street",
    "city": "Istanbul",
    "zip": "34000",
    "country": "TR",
    "phone": "+90.5321234567",
    "email": "info@example.com"
}

{
    "status": "success",
    "message": "هندل جدید با موفقیت ایجاد شد.",
    "data": {"handle": "P-ABC123"}
}

تنظیم هندل روی دامنه (هر چهار نقش) و قفل دامنه:

PUT https://parsdev.com/api/v1/domain/handles

{
    "domain": "example.com",
    "handle": "P-ABC123"
}

حذف هندل:

DELETE https://parsdev.com/api/v1/domain/handles?domain=example.com&handle=P-ABC123

چایلد نیم سرور

چایلد نیم سرور همیشه زیر همین دامنه ساخته می شود. فقط بخش اول نام (مثلا ns1) از درخواست خوانده می شود.

فهرست:

GET https://parsdev.com/api/v1/domain/child-nameservers?domain=example.com

ساخت و ویرایش:

POST https://parsdev.com/api/v1/domain/child-nameservers
PUT https://parsdev.com/api/v1/domain/child-nameservers

{
    "domain": "example.com",
    "ns": "ns1",
    "ip": "192.0.2.10"
}

حذف:

DELETE https://parsdev.com/api/v1/domain/child-nameservers?domain=example.com&ns=ns1