4.3. Notices and Remarks (通知と備考)

"notices" と "remarks" データ構造は同じ形式をとります。notices 構造は RDAP 情報を提供するサービスに関する情報および/またはレスポンス全体に関する情報を表し, 一方 remarks 構造はそれを含むオブジェクトクラスに関する情報を表します (オブジェクトクラスについては第 5 節を参照)。

両方ともオブジェクトの配列です。各オブジェクトには, オブジェクトのタイトルを表す "title" 文字列, 登録された備考または通知のタイプを示す "type" 文字列 (第 10.2.1 節を参照), 説明的なテキストを伝える目的の "description" という名前の文字列配列, および第 4.2 節で説明されている "links" 配列が含まれます。"description" 配列は含まれなければなりません。他のすべての JSON 値はオプションです。

notices データ構造の例:

"notices" :
[
  {
    "title" : "Terms of Use",
    "description" :
    [
      "Service subject to The Registry of the Moon's TOS.",
      "Copyright (c) 2020 LunarNIC"
    ],
    "links" :
    [
      {
        "value" : "https://example.net/entity/XXXX",
        "rel" : "alternate",
        "type" : "text/html",
        "href" : "https://www.example.com/terms_of_use.html"
      }
    ]
  }
]

クライアントの仕事は, "description" 配列の文字列内の文に対する改行, 間隔, 表示の問題を決定することです。"description" 配列内の各文字列には, 意味的な区切りがある場所をクライアントに示す, 人間が読める単一の完全なテキストの区分が含まれています。

remarks データ構造の例:

"remarks" :
[
  {
    "description" :
    [
      "She sells sea shells down by the sea shore.",
      "Originally written by Terry Sullivan."
    ]
  }
]

"remarks" 配列内のオブジェクトには "links" 配列も含まれる場合があることに注意してください。

"title" と "description" フィールドは主に人間による使用を意図していますが, "type" 文字列には, プログラマティックな使用のために IANA に登録される既知の値が含まれます (第 10.2.1 節を参照)。

remarks データ構造の例:

"remarks" :
[
  {
    "type" : "object truncated due to authorization",
    "description" :
    [
      "Some registration data may not have been given.",
      "Use proper authorization credentials to see all of it."
    ]
  }
]

"remarks" 配列はレスポンス内の多くのオブジェクトクラスに現れますが, "notices" 配列はレスポンスの最上位のオブジェクトにのみ現れます。

4.3. Notices and Remarks (通知と備考)​

4.3. Notices and Remarks (通知と備考)