This article deals with WAPI commands specifically for the WEDOS DNS (NSSET) service. For information on how to set up WAPI and troubleshoot common issues, see the article WAPI – Manual.
This tutorial deals with WAPI commands for NSSET, which is only used by CZ domains. You can find instructions for DNS in the article WAPI – DNS.
This article provides information on the following requests:
- nsset-check – NSSET availability check
- nsset-info – NSSET information
- nsset-create – create NSSET
- nsset-update – update NSSET
- nsset-transfer – transfer NSSET from another registrar
- nsset-send-auth-info – send NSSET AUTH-ID
nsset-check
Use the nsset-check request to check whether the NSSET name is free for registration, or is in some other state.
Parameters
- tld – domain TLD
- name – NSSET name
Return Values
- 1000 = Az NSSET regisztrálható
- 2201 = érvénytelen TLD
- 2247 = nem támogatott NSSET-formátum
- 3242 = Az NSSET nem elérhető
- 3245 = Az NSSET már regisztrálva van
- 3246 = nem elérhető
- 3247 = nem elérhető
- 3248 = nem elérhető – karantén
- 3249 = nem elérhető – fenntartott
- 3250 = nem elérhető – blokkolt
- 3251 = már regisztrálva van (nálunk)
- 4218 = a küldés sikertelen – kommunikációs hiba
Return Data
The request returns no data.
Templates
JSON request:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "nsset-check",
"clTRID": "your ID",
"data": {
"tld": "cz",
"name": "NSSET name"
}
}
}
JSON response (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "nsset-check"
}
}
nsset-info
Use the nsset-info request to download information about an NSSET.
Parameters
- tld – TLD
- name – NSSET name
Return Values
- 1000 = OK
- 2201 = érvénytelen TLD
- 2209 = szintaktikai hiba
- 2247 = nem támogatott NSSET-formátum
- 3214 = hiba – az NSSET betöltése sikertelen
- 3242 = Az NSSET nem elérhető
- 4204 = kapcsolódási hiba, próbálja újra később
Return Data
If successful, the request returns an nsset element in the data node with the following entries:
- name – NSSET name
- status – status
- reg_owner – current registrar
- reg_creator – NSSET creator (registrar)
- reg_update – registrar who made last update
- created_date – date of creation
- updated_date – date of last update
- transfer_date – date of transfer to another registrar
- tech_c – NSSET technical contact
- dns – DNS server list
- server
- name – server name
- addr_ipv4 – IPv4 server address
- addr_ipv6 – IPv6 server address
Templates
JSON request:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "nsset-info",
"clTRID": "your ID",
"data": {
"tld": "cz",
"name": "NSSET name"
}
}
}
JSON response (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "nsset-info",
"data": {
"nsset": {
"name": "NSSET name",
"status": "status",
"reg_owner": "current registrar",
"reg_creator": "NSSET creator (registrar)",
"reg_update": "last update registrar",
"created_date": "date and time of creation",
"updated_date": "date and time of last update",
"transfer_date": "date and time of last transfer",
"tech_c": "technical contact ID",
"dns": {
"server1": {
"name": "DNS server name",
"addr_ipv4": "DNS server IPv4",
"addr_ipv6": "DNS server IPv6"
}
}
}
}
}
}
nsset-create
Use the nsset-create request to create a new NSSET. NSSET contains a list of NS servers, each server contains a name entry and possibly also its IP address. You can also set a technical contact – if you do not, the default (WEDOS) will be set.
Parameters
- tld – TLD
- name – NSSET name
- dns – list of ns servers, each server entry contains information about that ns server
- server
- name – name (domain address)
- addr_ipv4 – IPv4 address
- addr_ipv6 – IPv6 adsress
- server
- tech_c – technical contact – optional
Return Values
- 1000 = OK, az NSSET létrejött
- 2201 = hibás TLD lett megadva
- 2210 = az ns szerverek formátuma érvénytelen
- 2211 = túl sok ns szerver
- 2216 = érvénytelen szintaxis a technikai kapcsolattartóban
- 2247 = nem támogatott NSSET-formátum
- 3228 = nem támogatja a kapcsolattartókkal való munkát
- 3229 = hiba a kapcsolattartó betöltésekor
- 3242 = Az NSSET nem elérhető
- 3244 = Az NSSET létrehozása sikertelen
- 3245 = Az NSSET már regisztrálva van
- 3246 = nem elérhető
- 3247 = nem elérhető
- 3248 = nem elérhető – karantén
- 3249 = nem elérhető – fenntartott
- 3250 = nem elérhető – blokkolt
- 3251 = már regisztrálva van
- 4212 = kapcsolódási hiba
- 4218 = az ellenőrzés sikertelen – kommunikációs hiba
- 4219 = a létrehozás sikertelen – kommunikációs hiba
Return Data
If successful, the command in the data node returns:
- nsset – the created NSSET name
Templates
JSON request:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "nsset-create",
"clTRID": "your ID",,
"data": {
"tld": "cz",
"name": "NSSET name",
"dns": {
"server1": {
"name": "DNS server name",
"addr_ipv4": "DNS server IPv4 address",
"addr_ipv6": "DNS server IPv6 address"
}
},
"tech_c": "technical contact ID"
}
}
}
JSON response (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "nsset-create",
"data": {
"nsset": "NSSET name"
}
}
}
nsset-update
Use the nsset-update request to modify an existing NSSET. The old entry will be completely overwritten, so enter all data carefully.
Parameters
- tld – TLD – required
- auth_info – NSSET AUTH-ID – required
- name – NSSET name – required
- dns – list of ns servers, each server entry contains information about that ns server – required
- server – at least 2 required
- name – server domain name – required
- addr_ipv4 – IPv4 address – optional
- addr_ipv6 – IPv6 address – optional
- server – at least 2 required
- tech_c – technical contact ID – required
Return Values
- 1000 = OK, az NSSET módosítva lett
- 2201 = hibás TLD lett megadva
- 2209 = szintaktikai hiba
- 2210 = a DNS-szerverek listájának formátuma érvénytelen
- 2211 = túl sok DNS-szerver
- 2216 = érvénytelen szintaxis a kapcsolattartóban
- 2247 = érvénytelen NSSET
- 3214 = hiba – az NSSET betöltése sikertelen
- 3228 = nem támogatja a kapcsolattartókkal való munkát
- 3229 = hiba a kapcsolattartó betöltésekor
- 3242 = Az NSSET ehhez a domainhez nem támogatott
- 3252 = jogosultsági hiba
- 3254 = Az NSSET módosítása sikertelen
- 4204 = Az NSSET nem elérhető – kapcsolódási hiba
- 4220 = Az NSSET módosítása sikertelen – kapcsolódási hiba
- 4212 = a kapcsolattartó nem elérhető – kapcsolódási hiba
Return Data
The request returns no data.
Templates
JSON request:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "nsset-update",
"clTRID": "your ID",
"data": {
"tld": "cz",
"name": "NSSET name",
"auth_info": "NSSET AUTH-ID",
"dns": {
"server1": {
"name": "DNS server name"
},
"server2": {
"name": "DNS server name"
}
},
"tech_c": "technical contact ID"
}
}
}
JSON response (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "nsset-update"
}
}
nsset-transfer
The nsset-transfer request changes the NSSET registrar to WEDOS.
Parameters
- tld – TLD
- name – NSSET name
- auth_info – NSSET AUTH-ID
Return Values
- 1000 = OK
- 2100 = hiányzik egy kötelező paraméter
- 2101 = érvénytelen bemeneti paraméterek
- 2201 = nem támogatott TLD
- 2209 = szintaktikai hiba
- 2215 = hiányzik az auth_info
- 2247 = érvénytelen NSSET-név
- 2249 = Az NSSET átvitele ehhez a TLD-hez nem engedélyezett
- 3214 = hiba – az NSSET betöltése sikertelen
- 3242 = Az NSSET nem támogatott
- 3251 = Az NSSET már regisztrálva van ennél a regisztrátornál
- 3255 = jogosultsági hiba
- 3256 = Az NSSET átvitele sikertelen
- 4204 = Az NSSET betöltése sikertelen – kapcsolódási hiba
- 4221 = Az NSSET átvitele sikertelen – kapcsolódási hiba
Return Data
The request returns no data.
Templates
JSON command:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "nsset-transfer",
"clTRID": "your ID",
"data": {
"tld": "cz",
"name": "NSSET name",
"auth_info": "NSSET AUTH-ID"
}
}
}
JSON response (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "nsset-transfer"
}
}
nsset-send-auth-info
The nsset-send-auth-info request sends the NSSET AUTH-ID to the NSSET technical contact email.
Parameters
- tld – TLD
- name – NSSET name
Return Values
- 1000 = OK, az auth_info elküldve a kapcsolattartó e-mail-címére
- 2201 = nem támogatott TLD
- 2209 = NSSET szintaktikai hiba
- 2216 = a kapcsolattartó szintaktikai hibája
- 2243 = ehhez az NSSET-hez nem engedélyezett a hitelesítési kód küldése
- 2247 = nem támogatott NSSET-formátum
- 3214 = hiba – az NSSET beolvasása sikertelen
- 3217 = a hitelesítési kód elküldése sikertelen
- 3228 = nem támogatja a kapcsolattartókkal való munkát
- 3229 = a kapcsolattartó beolvasása sikertelen
- 3242 = Az NSSET nem elérhető
- 3257 = a küldés sikertelen, az NSSET nem elérhető
- 4204 = Az NSSET nem elérhető – a kapcsolódás sikertelen
- 4212 = a kapcsolattartó nem elérhető – a kapcsolódás sikertelen
- 4222 = a küldés sikertelen – a kapcsolódás nem sikerült
Return Data
The request returns no data.
Templates
JSON request:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "nsset-send-auth-info",
"clTRID": "your ID",
"data": {
"tld": "cz",
"name": "NSSET name"
}
}
}
JSON response (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "nsset-send-auth-info"
}
}