Domain Tags

Tags can be created any way you like an be assigned to Domains and TLD Zones. Our system offers two different types of Tags:

TLD Zone Tags: Automatically apply to all domains of a certain TLD Zone.
Domain Tags: Must be assigned explicitly to domains.

Tags also show up in your domainlist.csv file, available in your new CentralNic Reseller Control Panel at “Downloads” -> “My Downloads” Download, or in your old CentralNic Reseller Control Panel at “Account” -> “FTP”. Internally we’re handling Tags with a unique ID, and not with a unique name to allow name changes at a later time. However, the name must be unique for each type. If an object (e.g. a Domain) is deleted, the Tags are saved so they can be retrieved upon a restore. However, this only applies if respective Tags have not been deleted in the meantime. Multiple Tags can be stated in query commands and work as logical conjunction. The response lists the intersection, i.e. all objects assigned to all Tags stated in the query command. Important: All objects you would like to tag, like Domains, need to be in your account, i.e. you cannot assign Tags to objects not managed inside your account. As a logical consequence, Tags will be removed from objects when they leave your account, for example when a Domain is transferred out of your account. Directly affected commands are TransferDomain and PushObject. When executed successfully, the Domain looses all Tag assignments.

How It Works

Tags can currently be created for and assigned to Domains and TLD Zones. The simple approach is:

Create a Tag
Assign a Tag to an object
Use the Tags!

Tags can be used for many purposes and they have been integrated in several commands.

Domain Tags

Domain Tags can be assigned directly to Domains using AddTag an will show up in responses of various commands. Also, Domain Tags will show up in the domainlist.csv file in your FTP area. Domain Tags can also be assigned using AddDomain and ModifyDomain, even if the respective Tags don’t exist yet. If a Tag doesn’t exist, it will be created. In case a Tag can not be created (e.g. because of invalid or too many characters), this Tag will be ignored and the command response will show an error: property[error][X]
In case a Tag not assigned to a certain Domain shall be removed from this Domain, it will be simply ignored without throwing an error.

TLD Zone Tags

Of course you can create new Tags for TLD Zones and thus you can set up a single Tag for a whole bunch of TLDs, making the management a bit easier. And these Tags for TLD Zones - both default Tags and individually created - automatically apply to all Domains of the respective TLD Zones, i.e. these do not need to be added to single Domains explicitly.
Our system offers default Tags for TLD Zones which automatically apply to all Domains of the respective TLD Zones. Those Tags can be recognised easily as they all start with DEFAULT_ and cannot be deleted or modified.
For example using

Command=QueryDomainlist
ZoneTag0=DEFAULT_GENERIC

lists all Domains of generic TLDs.
TLD Zone Tags can be applied for inactive TLD Zones as well. Default Tags can exist for inactive zones as well.
Important: Only valid Zones will work, i.e. only those that exist in the Metaregistry.

Default Tags

Default Tags can be used for Domains and TLD Zones, as well as template using the parameter COPY when using AddTag.
Important: Tag names starting with DEFAULT_ are reserved for Default Tags:

DEFAULT_ADULT
DEFAULT_BRAND
DEFAULT_CENTRALNIC
DEFAULT_COMMERCE
DEFAULT_COMPANY
DEFAULT_COMPUTER
DEFAULT_CULTURE
DEFAULT_EDUCATION
DEFAULT_ENVIRONMENT
DEFAULT_FAMILY
DEFAULT_FASHION
DEFAULT_FINANCIAL
DEFAULT_FOOD
DEFAULT_GENERIC
DEFAULT_GEOGRAPHIC
DEFAULT_GEOGRAPHIC/AFRICA
DEFAULT_GEOGRAPHIC/AMERICA
DEFAULT_GEOGRAPHIC/ASIA
DEFAULT_GEOGRAPHIC/AUSTRALIA
DEFAULT_GEOGRAPHIC/EUROPE
DEFAULT_GEOGRAPHIC/MIDDLEEAST
DEFAULT_GEOGRAPHIC/OCEANIA
DEFAULT_GEOGRAPHIC/SOUTHAMERICA
DEFAULT_HEALTH
DEFAULT_IDN/
DEFAULT_IDN/ARABIC
DEFAULT_IDN/CHINESE
DEFAULT_IDN/CYRILLIC
DEFAULT_IDN/DEVANAGARI
DEFAULT_IDN/HEBREW
DEFAULT_IDN/JAPANESE
DEFAULT_IDN/THAI
DEFAULT_INTEREST
DEFAULT_LIFESTYLE
DEFAULT_MEDIA
DEFAULT_OTHER
DEFAULT_POLITICS
DEFAULT_PUBLICITY
DEFAULT_REGIONAL
DEFAULT_RELIGION
DEFAULT_SPORT
DEFAULT_TECHNOLOGY
DEFAULT_THIRDLEVEL
DEFAULT_VEHICLE

Technical Specification for Tags

maximum length 64 characters
Zone Tags cannot start with “DEFAULT_”
Tags cannot have the name “0” (number zero)
100 Tags maximum per Domain
no limitation for Tag Zones per TLD/zone Tag since default groups can be large
all special and unicode characters can be used for Tags.
The ACL group for Tag commands is TOOLS. So if you want to grant access to Tag commands to users of your CentralNic Reseller account, the group TOOLS must be activated for them.

Additional Parameters and Responses for Commands

Important: Tags can not be assigned using TransferDomain, since transfers are often not in real-time.

Parameters for Query Commands

The following API commands now support the COMMAND parameters DomainTag[0-4095]= and ZoneTag[0-4095]= to limit the search results:

QueryRegisteredPremiumDomainList
QueryDomainRenewList
QueryTrusteeDomainList
QueryAccountingList
QueryDomainListByContact
QueryDomainHistoryList
QueryUpcomingAccountingList
QueryDomainExpireList
QueryDomainList

Example parameters:
…
ZoneTag0=
…
ZoneTag4095=
…
DomainTag0=
…
DomainTag4095=
…

Responses for StatusDomain, StatusDomain and GetZoneInfo

The following API commands now additionally respond with property[domaintag][0-X]=

StatusDomainHistory
StatusDomain

GetZoneInfo now additionally responds with property[tag][0-X]=

AddDomain

AddDomain now supports DOMAINTAG[0-4095]= for the direct assignment of Tags during the registration request.
Example parameters:
[[AddDomain|AddDomain]]
DomainTag0=
DomainTagN=
- or -
AddDomainTag0=
AddDomainTagN=

ModifyDomain

ModifyDomain now supports DOMAINTAG[0-4095]= for direct assignment of Tags during the registration request along with ADDDOMAINTAG[0-4095]= and DELDOMAINTAG[0-4095]=.
Example parameters:
[[ModifyDomain|ModifyDomain]]
DomainTag0=
DomainTagN=
- or -
AddDomainTag0=
AddDomainTagN=
DelDomainTag0=
DelDomainTagN=

CheckDomains With TLD Zone Tags

The command CheckDomains now also works with TLD Zone Tags and checks for a given search string. The search string can be stated without any TLD. The response automatically displays results for TLDs that belong to a certain TLD Zone Tag. Of course default and individual TLD Zone Tags can be combined.

Command

Command=CheckDomains
Domain0=cooldomainname
ZONETAG=DEFAULT_GENERIC

Response

code = 200
description = Command completed successfully
queuetime = 0
runtime = 10.36
property[column][0] = domain
property[column][1] = domaincheck
property[column][2] = domainchecktime
property[count][0] = 15
property[domain][0] = cooldomainname.biz
property[domaincheck][0] = 210 Domain name available
property[domainchecktime][0] = 0.001
property[domain][1] = cooldomainname.com
property[domaincheck][1] = 210 Domain name available
property[domainchecktime][1] = 0.001
property[domain][2] = cooldomainname.info
property[domaincheck][2] = 210 Domain name available
property[domainchecktime][2] = 0.001
...
property[first][0] = 0
property[last][0] = 14
property[limit][0] = 32
property[total][0] = 16

Using Query Commands With Tags

We integrated Tag support for Several Query Commands:

QueryDomainList
QueryAccountingList
QueryDomainExpireList
QueryDomainHistoryList
QueryDomainListByContact
QueryDomainRenewList
QueryRegisteredPremiumDomainList
QueryTrusteeDomainList
QueryUpcomingAccountingList

Using QueryDomainList and Tags To Narrow Down the List of Domains

To narrow down a query using tags the parameters DomainTag[x] and ZoneTag[x] can be used. You can query for up to 4096 Tags (from 0 to 4095) of each type and work as logical conjunction. The response lists the intersection, i.e. all objects assigned to all Tags stated in the query command.

Command

command=QueryDomainlist
ZoneTag0=DEFAULT_GENERIC

Response

code = 200
description = Command completed successfully
runtime = 0.009
property[column][0] = domain
property[count][0] = 2
property[domain][0] = first-domain1.com
property[domain][1] = first-domain2.com
property[first][0] = 0
property[last][0] = 1
property[limit][0] = 1000
property[total][0] = 2

Sub-Reseller Management With TLD Zone Tags

Tags can be used to activate TLD zones for Sub-Resellers, during the creation (AddRegistrar) and modification (ModifyRegistrar) of a Sub-Reseller account. Important: Tags are not inherited to Sub-Reseller accounts!

AddRegistrar With TLD Zone Tags

Important: Only TLD Zones currently assigned to the respective Tag will be activated. Changes to the used Tag at a later time will not be included, i.e. the activated TLD Zones will not changed.

Command

Command=AddRegistrar
...
ZoneTag0=
...
ZoneTag4095=
...

ModifyRegistrar With TLD Zone Tags

Deleting of ZoneTags containing Zones that are not activated for the respective Sub-Reseller account, will be ignored.
Important: Only TLD Zones currently assigned to the respective Tag will be activated. Changes to the used Tag at a later time will not be included, i.e. the activated TLD Zones will not changed.

Command

Command=ModifyRegistrar
AddZoneTag0=
...
AddZoneTag4095=
...
DelZoneTag0=
...
DelZoneTag4095=

Domain - Tags API-Commands

AddTag	Creates a new Tag
DeleteTag	DeleteTag
ModifyTag	ModifyTag
QueryTagList	Shows a list of all created Tags
StatusTag	StatusTag

API Command Examples

Add a new Tag for domains

Command

command=AddTag
type=DOMAIN
tag=tertius
description=number three

Add a new Tag for Domains and assign it to Domains using AddTag

Command

command=AddTag
type=DOMAIN
tag=primus
description=number one
domain0=first-domain1.com
domain1=first-domain2.com
domain2=first-domain3.com
domain3=first-domain4.com
domain4=first-domain5.com
domain5=first-domain6.com
domain6=first-domain7.com
domain7=first-domain8.com
domain8=first-domain9.com

Add a new Tag for a TLD Zone and assign it to TLD Zones using AddTag

Command

command=AddTag
type=ZONE
tag=rich
description=oh so wealthy
zone0=rich
zone1=luxury
zone2=diamonds

Add a new TLD Zone Tag using AddTag and COPY from an existing TLD Zone Tag

During creation of a new TLD Zone Tag you copy from an existing TLD Zone Tag or default Tag (always starting with DEFAULT_). The new TLD Zone Tag will contain all zones copied from the existing Tag.

Important

When using the parameter COPY additional TLD Zones can not be added.
COPY is only working with TLD Zone Tags.

Command

command=AddTag
type=ZONE
Copy=ExistingTag

Modifying Tags Using ModifyTag

Assign a Tag to some Domains using ModifyTag

Command

command=ModifyTag
type=DOMAIN
tag=secundus
adddomain0=second-domain1.com
adddomain1=second-domain2.com
adddomain2=second-domain3.com
adddomain3=second-domain4.com
adddomain4=second-domain5.com
adddomain5=second-domain6.com

Remove a Tag from some Domains using ModifyTag

Command

command=ModifyTag
type=DOMAIN
tag=primus
deldomain0=first-domain1.com
deldomain1=first-domain2.com
deldomain2=first-domain3.com
deldomain3=first-domain4.com
deldomain4=first-domain5.com
deldomain5=first-domain6.com

Assign and remove a Tag to/from some TLD Zones using ModifyTag

Command

command=ModifyTag
type=ZONE
tag=famous
addzone0=com
addzone1=net
addzone2=org
delzone3=info