Add record - API Documentation

HTTP method

POST

URL

https://api.zilore.com/dns/v1/domains/{domain_name}/records

Request parameters

Parameter	Description
domain_name	Domain name. Must conform to the standard. Names of national domains must be passed in Punycode format.
record_type	Record type: A — Establishes correspondence between a domain name/subdomain and its IPv4 address AAAA — Establishes correspondence between a domain name/subdomain and its IPv6 address CNAME — Establishes correspondence beteeem a subdomain and another domain name (cannot be used with a domain name directly) ALIAS — Establishes correspondence between a domain name/subdomain and another domain name (can be used without limitation) MX — Show mail servers for domain name/subdomain TXT — Includes arbitrary text information for the domain name/subdomain NS — Show authoritative DNS servers for domain name/subdomain SRV — Show location of servers for different services/domains PTR — Establishes correspondence between an IP address and its domain name/subdomain CAA — Defines SSL/TLS certificate issue policy for domain name/subdomain
record_ttl	Maximum permitted time for record to be cached. The list of possible values depends on your tariff plan and can be found using list_valid_record_ttl.
record_name	Name of record. Must conform to the standard. Names of national domains must be passed in Punycode format. Absolutely must include domain name. For example: foo.example.com if a record is being added to the example.com domain.
record_value	Record value. Must conform to the standard. Names of national domains must be passed in Punycode format. The format of the value depends on the record type.

Value format depending on record type:

A - Format: IPv4 address,
Example: 203.0.113.1
AAAA - Format: IPv6 address,
Example: 2001:0db8:0000:0000:0000:0000:0000:0000
CNAME - Format: Domain name,
Example: www.example.com
ALIAS - Format: Domain name,
Example: www.example.com
MX - Format: [Priority] [Domain name],
Example: 10 mail.example.com
TXT - Format: Text enclosed in double quotes
Example: "v=spf1 mx - all"
NS - Format: Domain name,
Example: ns1.example.com
SRV - Format: [Priority] [Weight] [Port] [Domain name],
Example: 1 10 5269 xmpp.example.com
PTR - Format: Domain name,
Example: www.example.com
CAA - Format: [Flags] [Tag] [Value],
Example: 0 issue "example.com; param=value"

The value of the record_value for TXT records parameter must be enclosed in double quotes.

The value of the record_value for MX, CAA, and SRV records parameter must be space-separated.

Response fields

Parameter	Description
record_id	Identifier for added record
record_status	Message on successful addition

Request example

POST https://api.zilore.com/dns/v1/domains/example.com/records
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0
Content-Type: application/x-www-form-urlencoded

record_name=www.example.com&record_type=A&record_value=203.0.113.1&record_ttl=3600

Response example

{
"status": "ok",
"response": {
"record_id": 1,
"record_status": "added"
}
}