Login

Add GEO-record

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"
}
}