blob: 889554fc9c01443af93b002df1311178cbe6cf1f [file] [log] [blame]
{
"basePath": "",
"baseUrl": "https://domainsrdap.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Domains RDAP",
"description": "Read-only public API that lets users search for information about domain names.",
"discoveryVersion": "v1",
"documentationLink": "https://developers.google.com/domains/rdap/",
"fullyEncodeReservedExpansion": true,
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "domainsrdap:v1",
"kind": "discovery#restDescription",
"name": "domainsrdap",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"alt": {
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"proto"
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
"type": "string"
},
"callback": {
"description": "JSONP",
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"type": "string"
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"autnum": {
"methods": {
"get": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/autnum/{autnumId}",
"httpMethod": "GET",
"id": "domainsrdap.autnum.get",
"parameterOrder": [
"autnumId"
],
"parameters": {
"autnumId": {
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v1/autnum/{autnumId}",
"response": {
"$ref": "RdapResponse"
}
}
}
},
"domain": {
"methods": {
"get": {
"description": "Look up RDAP information for a domain by name.",
"flatPath": "v1/domain/{domainId}",
"httpMethod": "GET",
"id": "domainsrdap.domain.get",
"parameterOrder": [
"domainName"
],
"parameters": {
"domainName": {
"description": "Full domain name to look up. Example: \"example.com\"",
"location": "path",
"pattern": "^[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/domain/{+domainName}",
"response": {
"$ref": "HttpBody"
}
}
}
},
"entity": {
"methods": {
"get": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/entity/{entityId}",
"httpMethod": "GET",
"id": "domainsrdap.entity.get",
"parameterOrder": [
"entityId"
],
"parameters": {
"entityId": {
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v1/entity/{entityId}",
"response": {
"$ref": "RdapResponse"
}
}
}
},
"ip": {
"methods": {
"get": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/ip/{ipId}/{ipId1}",
"httpMethod": "GET",
"id": "domainsrdap.ip.get",
"parameterOrder": [
"ipId",
"ipId1"
],
"parameters": {
"ipId": {
"location": "path",
"required": true,
"type": "string"
},
"ipId1": {
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v1/ip/{ipId}/{ipId1}",
"response": {
"$ref": "RdapResponse"
}
}
}
},
"nameserver": {
"methods": {
"get": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/nameserver/{nameserverId}",
"httpMethod": "GET",
"id": "domainsrdap.nameserver.get",
"parameterOrder": [
"nameserverId"
],
"parameters": {
"nameserverId": {
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v1/nameserver/{nameserverId}",
"response": {
"$ref": "RdapResponse"
}
}
}
},
"v1": {
"methods": {
"getDomains": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/domains",
"httpMethod": "GET",
"id": "domainsrdap.getDomains",
"parameterOrder": [],
"parameters": {},
"path": "v1/domains",
"response": {
"$ref": "RdapResponse"
}
},
"getEntities": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/entities",
"httpMethod": "GET",
"id": "domainsrdap.getEntities",
"parameterOrder": [],
"parameters": {},
"path": "v1/entities",
"response": {
"$ref": "RdapResponse"
}
},
"getHelp": {
"description": "Get help information for the RDAP API, including links to documentation.",
"flatPath": "v1/help",
"httpMethod": "GET",
"id": "domainsrdap.getHelp",
"parameterOrder": [],
"parameters": {},
"path": "v1/help",
"response": {
"$ref": "HttpBody"
}
},
"getIp": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/ip",
"httpMethod": "GET",
"id": "domainsrdap.getIp",
"parameterOrder": [],
"parameters": {},
"path": "v1/ip",
"response": {
"$ref": "HttpBody"
}
},
"getNameservers": {
"description": "The RDAP API recognizes this command from the RDAP specification but\ndoes not support it. The response is a formatted 501 error.",
"flatPath": "v1/nameservers",
"httpMethod": "GET",
"id": "domainsrdap.getNameservers",
"parameterOrder": [],
"parameters": {},
"path": "v1/nameservers",
"response": {
"$ref": "RdapResponse"
}
}
}
}
},
"revision": "20190828",
"rootUrl": "https://domainsrdap.googleapis.com/",
"schemas": {
"HttpBody": {
"description": "Message that represents an arbitrary HTTP body. It should only be used for\npayload formats that can't be represented as JSON, such as raw binary or\nan HTML page.\n\n\nThis message can be used both in streaming and non-streaming API methods in\nthe request as well as the response.\n\nIt can be used as a top-level request field, which is convenient if one\nwants to extract parameters from either the URL or HTTP template into the\nrequest fields and also want access to the raw HTTP body.\n\nExample:\n\n message GetResourceRequest {\n // A unique request id.\n string request_id = 1;\n\n // The raw HTTP body is bound to this field.\n google.api.HttpBody http_body = 2;\n }\n\n service ResourceService {\n rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);\n rpc UpdateResource(google.api.HttpBody) returns\n (google.protobuf.Empty);\n }\n\nExample with streaming methods:\n\n service CaldavService {\n rpc GetCalendar(stream google.api.HttpBody)\n returns (stream google.api.HttpBody);\n rpc UpdateCalendar(stream google.api.HttpBody)\n returns (stream google.api.HttpBody);\n }\n\nUse of this type only changes how the request and response bodies are\nhandled, all other features will continue to work unchanged.",
"id": "HttpBody",
"properties": {
"contentType": {
"description": "The HTTP Content-Type header value specifying the content type of the body.",
"type": "string"
},
"data": {
"description": "The HTTP request/response body as raw binary.",
"format": "byte",
"type": "string"
},
"extensions": {
"description": "Application specific response metadata. Must be set in the first response\nfor streaming APIs.",
"items": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"Link": {
"description": "Links object defined in [section 4.2 of RFC\n7483](https://tools.ietf.org/html/rfc7483#section-4.2).",
"id": "Link",
"properties": {
"href": {
"description": "Target URL of a link. Example: \"http://example.com/previous\".",
"type": "string"
},
"hreflang": {
"description": "Language code of a link. Example: \"en\".",
"type": "string"
},
"media": {
"description": "Media type of the link destination. Example: \"screen\".",
"type": "string"
},
"rel": {
"description": "Relation type of a link. Example: \"previous\".",
"type": "string"
},
"title": {
"description": "Title of this link. Example: \"title\".",
"type": "string"
},
"type": {
"description": "Content type of the link. Example: \"application/json\".",
"type": "string"
},
"value": {
"description": "URL giving context for the link. Example: \"http://example.com/current\".",
"type": "string"
}
},
"type": "object"
},
"Notice": {
"description": "Notices object defined in [section 4.3 of RFC\n7483](https://tools.ietf.org/html/rfc7483#section-4.3).",
"id": "Notice",
"properties": {
"description": {
"description": "Description of the notice.",
"items": {
"type": "string"
},
"type": "array"
},
"links": {
"description": "Link to a document containing more information.",
"items": {
"$ref": "Link"
},
"type": "array"
},
"title": {
"description": "Title of a notice. Example: \"Terms of Service\".",
"type": "string"
},
"type": {
"description": "Type values defined in [section 10.2.1 of RFC\n7483](https://tools.ietf.org/html/rfc7483#section-10.2.1) specific to a\nwhole response: \"result set truncated due to authorization\", \"result set\ntruncated due to excessive load\", \"result set truncated due to\nunexplainable reasons\".",
"type": "string"
}
},
"type": "object"
},
"RdapResponse": {
"description": "Response to a general RDAP query.",
"id": "RdapResponse",
"properties": {
"description": {
"description": "Error description.",
"items": {
"type": "string"
},
"type": "array"
},
"errorCode": {
"description": "Error HTTP code. Example: \"501\".",
"format": "int32",
"type": "integer"
},
"jsonResponse": {
"$ref": "HttpBody",
"description": "HTTP response with content type set to \"application/json+rdap\"."
},
"lang": {
"description": "Error language code. Error response info fields are defined in [section 6\nof RFC 7483](https://tools.ietf.org/html/rfc7483#section-6).",
"type": "string"
},
"notices": {
"description": "Notices applying to this response.",
"items": {
"$ref": "Notice"
},
"type": "array"
},
"rdapConformance": {
"description": "RDAP conformance level.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Error title.",
"type": "string"
}
},
"type": "object"
}
},
"servicePath": "",
"title": "Domains RDAP API",
"version": "v1",
"version_module": true
}