Add GEO-record - API Documentation

HTTP method

POST

URL

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

Request parameters

Parameter	Description
domain_name	Domain name. Must conform to the standard. Names of national domains must be passed in Punycode format.
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_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)
geo_region	GEO-identifier of the record from geo_records
record_value	Record value for the region. 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.

Warning! GEO-records can only be created with the record_name and record_type values listed in the geo_records request

Record value formats by 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

Response fields

Parameter	Description
record_id	Identifier for added geo record

Request example

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

record_name=a.example.com&record_type=A&record_value=1.1.1.100&geo_region=_NA

Response example

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