forked from docs/doc-exports
Qin Ying, Fan
a79d5bdbdb
Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com> Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com> Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
13 lines
2.8 KiB
HTML
13 lines
2.8 KiB
HTML
<a name="dns_api_50000"></a><a name="dns_api_50000"></a>
|
|
|
|
<h1 class="topictitle1">API Usage Guidelines</h1>
|
|
<div id="body8662426"><p id="dns_api_50000__en-us_topic_0020507759_p1645204610259">Public cloud APIs comply with the RESTful API design principles. REST-based web services are organized into resources. Each resource is identified by one or more Uniform Resource Identifiers (URIs). An application accesses a resource based on the resource's Unified Resource Locator (URL). A URL is usually in the following format: https://<em id="dns_api_50000__en-us_topic_0020507759_i137795958918721">Endpoint/uri</em>. In the URL, <em id="dns_api_50000__en-us_topic_0020507759_i842352697154116">uri</em> indicates the resource path, that is, the API access path.</p>
|
|
<p id="dns_api_50000__p1552614442327">An endpoint is the <strong id="dns_api_50000__b255825310314">request address</strong> for calling an API. Endpoints vary depending on services and regions. For DNS endpoints, see <a href="https://docs.otc.t-systems.com/endpoint/index.html" target="_blank" rel="noopener noreferrer">Regions and Endpoints</a>.</p>
|
|
<ul id="dns_api_50000__ul79950321506"><li id="dns_api_50000__li1878518469161">Private zone APIs and related APIs call different endpoints based on the region.<p id="dns_api_50000__p1361911711177"><a name="dns_api_50000__li1878518469161"></a><a name="li1878518469161"></a>For example, call the API provided in <a href="dns_api_63000.html">Private Zone Management</a> to create a private zone, and call the API provided in <a href="dns_api_64000.html">Record Set Management</a> to add a record set to a private zone.</p>
|
|
</li><li id="dns_api_50000__li7995123212017">Public zone APIs, PTR record APIs, and related APIs call only endpoint dns.eu-de.otc.t-systems.com in the <strong id="dns_api_50000__b74817533612">eu-de</strong> region.<p id="dns_api_50000__p27460802018">For example, call the API provided in <a href="dns_api_62000.html">Public Zone Management</a> to create a public zone, call the API provided in <a href="dns_api_64000.html">Record Set Management</a> to add a record set to a public zone, and call the API provided in <a href="dns_api_66000.html">PTR Record Management</a> to add a PTR record.</p>
|
|
</li></ul>
|
|
<p id="dns_api_50000__en-us_topic_0020507759_p4816427810259">Public cloud APIs use HTTPS as the transmission protocol. Requests/Responses are transmitted using JSON messages, with the media type represented by <strong id="dns_api_50000__en-us_topic_0020507759_b1025950229154127">Application/json</strong>.</p>
|
|
<p id="dns_api_50000__en-us_topic_0020507759_p188289482118">For details about how to use APIs, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328001.html?tag=API Documents" target="_blank" rel="noopener noreferrer">API Usage Guidelines</a>.</p>
|
|
</div>
|
|
|