Registration Data Access Protocol (RDAP) Query Format
RFC 7482
Document | Type | RFC - Proposed Standard (March 2015; Errata) | |
---|---|---|---|
Authors | Andrew Newton , Scott Hollenbeck | ||
Last updated | 2020-01-21 | ||
Replaces | draft-hollenbeck-weirds-unified-rdap-query | ||
Stream | IETF | ||
Formats | plain text html pdf htmlized with errata bibtex | ||
Reviews | |||
Stream | WG state | Submitted to IESG for Publication | |
Document shepherd | Murray Kucherawy | ||
Shepherd write-up | Show (last changed 2014-09-22) | ||
IESG | IESG state | RFC 7482 (Proposed Standard) | |
Action Holders |
(None)
|
||
Consensus Boilerplate | Yes | ||
Telechat date | |||
Responsible AD | Pete Resnick | ||
Send notices to | (None) | ||
IANA | IANA review state | Version Changed - Review Needed | |
IANA action state | No IANA Actions |
Internet Engineering Task Force (IETF) A. Newton Request for Comments: 7482 ARIN Category: Standards Track S. Hollenbeck ISSN: 2070-1721 Verisign Labs March 2015 Registration Data Access Protocol (RDAP) Query Format Abstract This document describes uniform patterns to construct HTTP URLs that may be used to retrieve registration information from registries (including both Regional Internet Registries (RIRs) and Domain Name Registries (DNRs)) using "RESTful" web access patterns. These uniform patterns define the query syntax for the Registration Data Access Protocol (RDAP). Status of This Memo This is an Internet Standards Track document. This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741. Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc7482. Copyright Notice Copyright (c) 2015 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Newton & Hollenbeck Standards Track [Page 1] RFC 7482 RDAP Query Format March 2015 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Conventions Used in This Document . . . . . . . . . . . . . . 4 2.1. Acronyms and Abbreviations . . . . . . . . . . . . . . . 4 3. Path Segment Specification . . . . . . . . . . . . . . . . . 4 3.1. Lookup Path Segment Specification . . . . . . . . . . . . 5 3.1.1. IP Network Path Segment Specification . . . . . . . . 6 3.1.2. Autonomous System Path Segment Specification . . . . 7 3.1.3. Domain Path Segment Specification . . . . . . . . . . 7 3.1.4. Nameserver Path Segment Specification . . . . . . . . 8 3.1.5. Entity Path Segment Specification . . . . . . . . . . 9 3.1.6. Help Path Segment Specification . . . . . . . . . . . 9 3.2. Search Path Segment Specification . . . . . . . . . . . . 9 3.2.1. Domain Search . . . . . . . . . . . . . . . . . . . . 10 3.2.2. Nameserver Search . . . . . . . . . . . . . . . . . . 11 3.2.3. Entity Search . . . . . . . . . . . . . . . . . . . . 12 4. Query Processing . . . . . . . . . . . . . . . . . . . . . . 13 4.1. Partial String Searching . . . . . . . . . . . . . . . . 13 4.2. Associated Records . . . . . . . . . . . . . . . . . . . 14 5. Extensibility . . . . . . . . . . . . . . . . . . . . . . . . 14 6. Internationalization Considerations . . . . . . . . . . . . . 15 6.1. Character Encoding Considerations . . . . . . . . . . . . 15 7. Security Considerations . . . . . . . . . . . . . . . . . . . 16 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 17 8.1. Normative References . . . . . . . . . . . . . . . . . . 17 8.2. Informative References . . . . . . . . . . . . . . . . . 19 Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 19 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 20 1. Introduction This document describes a specification for querying registration data using a RESTful web service and uniform query patterns. The service is implemented using the Hypertext Transfer Protocol (HTTP) [RFC7230] and the conventions described in [RFC7480]. These uniform patterns define the query syntax for the Registration Data Access Protocol (RDAP). The protocol described in this specification is intended to address deficiencies with the WHOIS protocol [RFC3912] that have been identified over time, including: o lack of standardized command structures; o lack of standardized output and error structures; o lack of support for internationalization and localization; and Newton & Hollenbeck Standards Track [Page 2]Show full document text