Login

Get list of records to which GEO records can be added

HTTP method

GET

URL

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

Request parameters

Parameter

Description

domain_name

Domain name. Must conform to the standard. Names of national domains must be passed in Punycode format.

Response fields

Parameter

Description

record_name

Name of record in Unicode 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)

record_ttl

Maximum permitted time for record to be cached

records

Array of identifiers and values of records with the same name

  • record_id — Record identifier
  • record_status — Record status (enabled|disabled)
  • record_value — Record value in Unicode format

Request example

GET https://api.zilore.com/dns/v1/domains/example.com/geo/defaults
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0

Response example

{
"status": "ok",
"response": {
"geo_records": [{
"record_name": "www.example.com",
"record_ttl": "60",
"record_type": "A",
"records": [{
"record_id": "12306",
"record_status": "enabled",
"record_value": "1.1.1.2"
}]
}, {
"record_name": "xxx.example.com",
"record_type": "AAAA",
"record_ttl": "3600",
"records": [{
"record_id": "12307",
"record_status": "enabled",
"record_value": "0::1:2:4"
}]
}, {
"record_name": "example.com",
"record_type": "A",
"record_ttl": "3600",
"records": [{
"record_id": "12582",
"record_status": "disabled",
"record_value": "6.6.6.7"
}]
}],
"geo_regions": {
"_AF": {
"continent_name": "Africa",
"countries": {
"DZ": {
"country_name": "Algeria",
"subdivisions": {
"DZ.01": "Adrar",
"DZ.16": "Algiers",
"DZ.23": "Annaba",
"...": "..."
}
},
"AO": {
"country_name": "Angola",
"subdivisions": {
"AO.BGO": "Bengo Province",
"AO.BGU": "Benguela",
"AO.BIE": "Bíe",
"...": "..."
}
},
"...": "{...}"
}
},
"_AS": {
"continent_name": "Asia",
"countries": {
"AF": {
"country_name": "Afghanistan",
"subdivisions": {
"AF.HER": "Herat",
"AF.KAB": "Kabul",
"AF.KAN": "Kandahar",
"...": "..."
}
},
"AM": {
"country_name": "Armenia",
"subdivisions": {
"AM.AG": "Aragatsotn",
"AM.AR": "Ararat",
"...": "..."
}
},
"...": "{...}"
}
},
"_EU": {
"continent_name": "Europe",
"countries": {
"AL": {
"country_name": "Albania",
"subdivisions": {
"AL.BR": "Berat District",
"AL.EL": "Elbasan District",
"...": "..."
}
},
"AD": {
"country_name": "Andorra",
"subdivisions": {
"AD.07": "Andorra la Vella",
"AD.02": "Canillo",
"...": "..."
}
},
"...": "{...}"
}
},
"_NA": {
"continent_name": "North America",
"countries": {
"AI": {
"country_name": "Anguilla",
"subdivisions": []
},
"AG": {
"country_name": "Antigua and Barbuda",
"subdivisions": {
"AG.10": "Barbuda",
"AG.03": "Parish of Saint George",
"...": "..."
}
},
"...": "{...}"
}
},
"_SA": {
"continent_name": "South America",
"countries": {
"AR": {
"country_name": "Argentina",
"subdivisions": {
"AR.B": "Buenos Aires",
"AR.C": "Buenos Aires F.D.",
"...": "..."
}
},
"BO": {
"country_name": "Bolivia",
"subdivisions": {
"BO.H": "Departamento de Chuquisaca",
"BO.C": "Departamento de Cochabamba",
"...": "..."
}
},
"...": "{...}"
}
},
"_OC": {
"continent_name": "Oceania",
"countries": {
"AS": {
"country_name": "American Samoa",
"subdivisions": {
"AS.E": "Eastern District"
}
},
"AU": {
"country_name": "Australia",
"subdivisions": {
"AU.ACT": "Australian Capital Territory",
"AU.NSW": "New South Wales",
"...": "..."
}
},
"...": "{...}"
}
}
}
}
}