WEDOS Global Admin PanelAdmin Panel
Knowledge Base›WEDOS API (WAPI)›NSSET

WAPI – NSSET

In questa paginansset-checknsset-infonsset-creatensset-updatensset-transfernsset-send-auth-info

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

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 = L’NSSET è disponibile per la registrazione
  • 2201 = TLD non valido
  • 2247 = formato NSSET non supportato
  • 3242 = L’NSSET non è disponibile
  • 3245 = L’NSSET è già registrato
  • 3246 = non disponibile
  • 3247 = non disponibile
  • 3248 = non disponibile – in quarantena
  • 3249 = non disponibile – riservato
  • 3250 = non disponibile – bloccato
  • 3251 = già registrato (presso di noi)
  • 4218 = invio non riuscito – errore di comunicazione

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 = TLD non valido
  • 2209 = errore di sintassi
  • 2247 = formato NSSET non supportato
  • 3214 = errore – NSSET non caricato
  • 3242 = L’NSSET non è disponibile
  • 4204 = errore di connessione, riprova più tardi

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
  • tech_c – technical contact – optional

Return Values

  • 1000 = OK, NSSET creato
  • 2201 = TLD inserito non valido
  • 2210 = formato dei server ns non valido
  • 2211 = troppi server ns
  • 2216 = sintassi non valida nel contatto tecnico
  • 2247 = formato NSSET non supportato
  • 3228 = non supporta la gestione dei contatti
  • 3229 = errore nel caricamento del contatto
  • 3242 = L’NSSET non è disponibile
  • 3244 = Creazione dell’NSSET non riuscita
  • 3245 = L’NSSET è già registrato
  • 3246 = non disponibile
  • 3247 = non disponibile
  • 3248 = non disponibile – in quarantena
  • 3249 = non disponibile – riservato
  • 3250 = non disponibile – bloccato
  • 3251 = già registrato
  • 4212 = errore di connessione
  • 4218 = verifica non riuscita – errore di comunicazione
  • 4219 = creazione non riuscita – errore di comunicazione

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
  • tech_c – technical contact ID – required

Return Values

  • 1000 = OK, NSSET modificato
  • 2201 = TLD inserito non valido
  • 2209 = errore di sintassi
  • 2210 = formato dell’elenco dei server DNS non valido
  • 2211 = troppi server DNS
  • 2216 = sintassi non valida nel contatto
  • 2247 = NSSET non valido
  • 3214 = errore – NSSET non caricato
  • 3228 = non supporta la gestione dei contatti
  • 3229 = errore nel caricamento del contatto
  • 3242 = L’NSSET non è supportato per questo dominio
  • 3252 = errore di autorizzazione
  • 3254 = Modifica dell’NSSET non riuscita nsset
  • 4204 = L’NSSET non è disponibile – errore di connessione
  • 4220 = Modifica dell’NSSET non riuscita – errore di connessione
  • 4212 = il contatto non è disponibile – errore di connessione

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 = parametro obbligatorio mancante
  • 2101 = parametri di input non validi
  • 2201 = TLD non supportato
  • 2209 = errore di sintassi
  • 2215 = auth_info mancante
  • 2247 = nome NSSET non valido
  • 2249 = Il trasferimento dell’NSSET non è consentito per questo TLD
  • 3214 = errore – NSSET non caricato
  • 3242 = NSSET non supportato
  • 3251 = L’NSSET è già registrato presso questo registrar
  • 3255 = errore di autorizzazione
  • 3256 = Trasferimento dell’NSSET non riuscito
  • 4204 = NSSET non caricato – errore di connessione
  • 4221 = Trasferimento dell’NSSET non riuscito – errore di connessione

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, auth_info inviato all’e-mail di contatto
  • 2201 = TLD non supportato
  • 2209 = Errore di sintassi dell’NSSET
  • 2216 = errore di sintassi del contatto
  • 2243 = non è consentito inviare il codice di autorizzazione per questo NSSET
  • 2247 = formato NSSET non supportato
  • 3214 = errore – lettura dell’NSSET non riuscita
  • 3217 = invio del codice di autorizzazione non riuscito
  • 3228 = non supporta la gestione dei contatti
  • 3229 = lettura del contatto non riuscita
  • 3242 = L’NSSET non è disponibile
  • 3257 = invio non riuscito, NSSET non disponibile
  • 4204 = L’NSSET non è disponibile – connessione non riuscita
  • 4212 = il contatto non è disponibile – connessione non riuscita
  • 4222 = invio non riuscito – connessione non riuscita

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

Questo articolo le è stato utile?

Il suo giudizio ci aiuta a migliorare i nostri articoli.

Il suo messaggio viene letto dal team della documentazione, che però non risponde. Se ha bisogno di aiuto, contattici tramite il modulo di contatto. Non inserisca password né dati personali.

Guide correlate

WAPI – WEDOS Protection (WGP)

This article provides information on the WAPI commands tied to WEDOS Protection services.

WAPI – Manual

How WAPI works with WEDOS Global and how to activate it in the admin panel.

WAPI – WEDOS DNS

This article provides information on the WAPI commands tied to WEDOS DNS services.

Didn’t find what you were looking for?

Send us your question using the contact form.

Contact form