REST Resource: domain

المورد: RdapDomain

كائن النطاق كما هو محدّد في القسم 5.3 من RFC 7483. لا تتوفّر "خيارات المنتج" أو "publicIds" أو "الشبكة" في المواصفات.

تمثيل JSON 
{
  "objectClassName": string,
  "handle": string,
  "ldhName": string,
  "unicodeName": string,
  "nameservers": [
    {
      object (RdapNameserver)
    }
  ],
  "secureDNS": {
    object (SecureDns)
  },
  "entities": [
    {
      object (RdapEntity)
    }
  ],
  "status": [
    string
  ],
  "remarks": [
    {
      object (Remark)
    }
  ],
  "links": [
    {
      object (Link)
    }
  ],
  "port43": string,
  "events": [
    {
      object (Event)
    }
  ],
  "jsonResponse": {
    object (HttpBody)
  },
  "rdapConformance": [
    string
  ],
  "notices": [
    {
      object (Notice)
    }
  ],
  "lang": string,
  "errorCode": number,
  "title": string,
  "description": [
    string
  ]
}
الحقول
objectClassName

string

يجب ضبطها دائمًا على السلسلة "domain".

handle

string

سلسلة تمثّل معرّفًا فريدًا لقاعدة بيانات المسجّلين لمثيل عنصر النطاق

ldhName

string

سلسلة تصف اسم نطاق في نموذج LDH كما هو موضّح في القسم 3 من RFC 7483.

unicodeName

string

سلسلة تحتوي على اسم نطاق مع تصنيفات U كما هو موضّح في القسم 3 من RFC 7483.

nameservers[]

object (RdapNameserver)

مصفوفة من كائنات خادم الأسماء.

secureDNS

object (SecureDns)

اسم هذا الحقل هو حل بديل، وبالتالي يتم تنسيقه مع حقل JSON بالاسم "secureDNS".

entities[]

object (RdapEntity)

التواصل مع كيانات هذا النطاق

status[]

string

قائمة الحالات المطبَّقة على الكيان مثال: "التعديل محظور".

remarks[]

object (Remark)

الملاحظات ذات الصلة بالمجال

port43

string

خادم WHOIS لهذا النطاق. مثال: "whois.google.com".

events[]

object (Event)

الأحداث التي تؤثر في هذا النطاق.

jsonResponse

object (HttpBody)

استجابة HTTP مع نوع المحتوى الذي تم ضبطه على "application/json+rdap".

rdapConformance[]

string

مستوى التوافق مع بروتوكول RDAP يجب ملء هذه البيانات فقط إذا كان النطاق هو عنصر المستوى الأعلى للاستجابة.

notices[]

object (Notice)

الإشعارات ذات الصلة بالنطاق يجب ملء هذه البيانات فقط إذا كان النطاق هو عنصر المستوى الأعلى للاستجابة.

lang

string

رمز لغة الخطأ. تم تحديد حقول معلومات استجابة الخطأ في القسم 6 من RFC 7483.

errorCode

number

خطأ في رمز HTTP. مثال: "501".

title

string

عنوان الخطأ.

description[]

string

وصف الخطأ.

RdapNameserver

كائن خادم الأسماء كما هو موضّح في القسم 5.2 من RFC 7483. لم يتم تضمين "الاسم المعرِّف" و"الكيانات" و"الحالة" و"الملاحظات" و"الروابط" و"port43" و"events" في المواصفات.

تمثيل JSON 
{
  "objectClassName": string,
  "ldhName": string,
  "unicodeName": string,
  "ipAddresses": [
    {
      object (IpAddressObject)
    }
  ]
}
الحقول
objectClassName

string

يجب ضبطها دائمًا على السلسلة "nameserver".

ldhName

string

سلسلة تمثّل معرّفًا فريدًا لسجلّ خادم الأسماء كما هو موضّح في القسم 3 من RFC 7483.

unicodeName

string

سلسلة تحتوي على اسم DNS Unicode لخادم الأسماء كما هو موضّح في القسم 3 من RFC 7483.

ipAddresses[]

object (IpAddressObject)

عناوين IP لخادم الأسماء هذا.

IpAddressObject

تمثيل JSON 
{
  "v4": [
    string
  ],
  "v6": [
    string
  ]
}
الحقول
v4[]

string

مصفوفة من السلاسل التي تحتوي على عناوين IPv4 لخادم الأسماء.

v6[]

string

مصفوفة من السلاسل التي تحتوي على عناوين IPv6 لخادم الأسماء.

SecureDns

بيانات نظام أسماء النطاقات للنطاق. لا تتوفّر "أحداث" أو "روابط" في المواصفات.

تمثيل JSON 
{
  "zoneSigned": boolean,
  "delegationSigned": boolean,
  "maxSigLife": number,
  "dsData": [
    {
      object (DsData)
    }
  ],
  "keyData": [
    {
      object (KeyData)
    }
  ]
}
الحقول
zoneSigned

boolean

صحيح إذا تم توقيع المنطقة، وخطأ في الحالات الأخرى.

delegationSigned

boolean

صحيح إذا كانت هناك سجلات DS في العنصر الرئيسي، وخطأ في الحالات الأخرى.

maxSigLife

number

تمثِّل مدة التوقيع مدّة التوقيع بالثواني لاستخدامها عند إنشاء سجلّ RRSIG DS في المنطقة الرئيسية.

dsData[]

object (DsData)

سجلّات DS لنظام أسماء النطاقات كما هو موضّح في RFC 4034.

keyData[]

object (KeyData)

سجلّات DNSKEY للنطاق على النحو المحدّد في RFC 4034.

DsData

تمثيل JSON 
{
  "keyTag": number,
  "algorithm": number,
  "digest": string,
  "digestType": number
}
الحقول
keyTag

number

حقل العلامة الرئيسية لسجلّ DS لنظام أسماء النطاقات.

algorithm

number

حقل الخوارزمية لسجلّ DS لنظام أسماء النطاقات.

digest

string

حقل ملخص لسجلّ DS لنظام أسماء النطاقات

digestType

number

حقل نوع الملخص لسجلّ DS لنظام أسماء النطاقات.

KeyData

لا تتوفّر "أحداث" أو "روابط" في المواصفات.

تمثيل JSON 
{
  "flags": number,
  "protocol": number,
  "publicKey": string,
  "algorithm": number
}
الحقول
flags

number

وضع علامة على قيمة الحقل في سجلّ DNSKEY كما هو محدّد في RFC 4034.

protocol

number

قيمة حقل البروتوكول لسجلّ DNSKEY كما هو محدّد في RFC 4034.

publicKey

string

مفتاح عام في سجلّ DNSKEY كما هو محدّد في RFC 4034.

algorithm

number

حقل الخوارزمية لسجلّ DNSKEY كما هو محدّد في RFC 4034.

RdapEntity

كائن الكيان على النحو المحدّد في القسم 5.1 من RFC 7483. لا يتوفّر asEventActor و"networks" و"autnums" في المواصفات.

تمثيل JSON 
{
  "objectClassName": string,
  "handle": string,
  "vcardArray": [
    value
  ],
  "roles": [
    string
  ],
  "publicIds": [
    {
      object (PublicId)
    }
  ],
  "entities": [
    {
      object (RdapEntity)
    }
  ],
  "status": [
    string
  ],
  "remarks": [
    {
      object (Remark)
    }
  ],
  "links": [
    {
      object (Link)
    }
  ],
  "port43": string,
  "events": [
    {
      object (Event)
    }
  ]
}
الحقول
objectClassName

string

يجب ضبطها دائمًا على سلسلة "entity".

handle

string

سلسلة تمثِّل المعرّف الفريد في السجلّ الخاص بالكيان

vcardArray[]

value (Value format)

jCard مع معلومات الاتصال الخاصة بالكيان

roles[]

string

مصفوفة من السلاسل، تشير كل منها إلى العلاقة بين الكائن وأقرب كائن محتوي له.

publicIds[]

object (PublicId)

تمثّل هذه السمة المعرّف العلني للكيان، إذا كان متوفّرًا.

entities[]

object (RdapEntity)

يمكن أن تحتوي الكيانات أيضًا على كيانات أخرى مضمنة معها في صفيف. يمكن استخدام هذا لتصميم مؤسسة مع أفراد محددين يؤدون أدوارًا محددة للمسئولية.

نستخدم هذا النموذج لتمثيل جهة الاتصال المسؤولة عن إساءة الاستخدام: يجب أن يكون للكيانات التي لديها الدور "جهة التسجيل" داخل كائن النطاق عنصر كيان داخلي له دور "إساءة استخدام" وملف vCard المقابل له يتضمن عنوانَي الهاتف والبريد الإلكتروني لجهة الاتصال المسؤولة عن إساءة الاستخدام.
status[]

string

قائمة الحالات المطبَّقة على الكيان مثال: "خاص".

remarks[]

object (Remark)

الملاحظات المتعلقة بالكيان

port43

string

خادم WHOIS لهذا النطاق. مثال: "whois.google.com".

events[]

object (Event)

الأحداث التي تمت على هذا الكيان

PublicId

المعرّفات العامة المحدّدة في القسم 4.8 من RFC 7483.

تمثيل JSON 
{
  "type": string,
  "identifier": string
}
الحقول
type

string

نوع مستند التعريف. مثال: "رقم تعريف جهة تسجيل IANA"

identifier

string

نص مستند التعريف. مثال: "1".

ملاحظة

كائن ملاحظات محدّد في القسم 4.3 من RFC 7483.

تمثيل JSON 
{
  "type": string,
  "title": string,
  "description": [
    string
  ],
  "links": [
    {
      object (Link)
    }
  ]
}
الحقول
type

string

اكتب القيم وفقًا للفقرة 10.2.1 من RFC 7483 الخاصة بكائن واحد: "تم اقتطاع الكائن بسبب التفويض"، أو "تم اقتطاع العنصر بسبب التحميل الزائد"، و"تم اقتطاع الكائن لأسباب غير قابلة للتفسير"، و"تم إخفاء الكائن بسبب التفويض".

title

string

تمثّل هذه السمة عنوان الملاحظة.

description[]

string

تمثّل هذه السمة النص الفعلي للملاحظة.

حدث

كائن الأحداث محدّد في القسم 4.5 من RFC 7483.

تمثيل JSON 
{
  "eventAction": string,
  "eventDate": string,
  "eventActor": string,
  "links": [
    {
      object (Link)
    }
  ]
}
الحقول
eventAction

string

الإجراء الذي حدث في هذا الحدث مثال: "التسجيل".

eventDate

string (Timestamp format)

الطابع الزمني للحدث مثال: "1990-12-31T23:59:59Z".

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"
eventActor

string

الاسم المعرِّف لمنفِّذ الحدث مثال: "SOMEID-LUNARNIC". ومع ذلك، هناك نوع واحد من الأحداث يجب ألا يتضمّن eventActor. للحصول على معلومات حول هذا النوع من الأحداث، يمكنك الاطّلاع على القسم 5.1 من RFC 7483.

الطُرق

get

 البحث عن معلومات RDAP عن نطاق حسب الاسم