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 (通知和备注)