WAPI – NSSET

Este artículo ofrece información sobre las siguientes solicitudes:

• nsset-check – comprobación de disponibilidad del NSSET
• nsset-info – información del NSSET
• nsset-create – crear un NSSET
• nsset-update – actualizar un NSSET
• nsset-transfer – transferir un NSSET desde otro registrador
• nsset-send-auth-info – enviar el AUTH-ID del NSSET

---

nsset-check

Utilice la nsset-check solicitud para comprobar si el nombre del NSSET está libre para su registro o se encuentra en algún otro estado.

Parámetros

• tld – TLD del dominio
• name – nombre del NSSET

Valores devueltos

• 1000 = el NSSET está disponible para su registro
• 2201 = TLD no válido
• 2247 = formato de NSSET no admitido
• 3242 = el NSSET no está disponible
• 3245 = el NSSET ya está registrado
• 3246 = no disponible
• 3247 = no disponible
• 3248 = no disponible – en cuarentena
• 3249 = no disponible – reservado
• 3250 = no disponible – bloqueado
• 3251 = ya registrado (con nosotros)
• 4218 = error al enviar – error de comunicación

Datos devueltos

La solicitud no devuelve datos.

Plantillas

Solicitud JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-check",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-check"
  }
}

---

nsset-info

Utilice la nsset-info solicitud para obtener información sobre un NSSET.

Parámetros

• tld – TLD
• name – nombre del NSSET

Valores devueltos

• 1000 = OK
• 2201 = TLD no válido
• 2209 = error de sintaxis
• 2247 = formato de NSSET no admitido 
• 3214 = error – NSSET no cargado
• 3242 = el NSSET no está disponible
• 4204 = error de conexión, inténtelo de nuevo más tarde

Datos devueltos

Si se realiza correctamente, la solicitud devuelve un elemento nsset en el nodo data con las siguientes entradas:

• name – nombre del NSSET
• status – estado
• reg_owner – registrador actual
• reg_creator – creador del NSSET (registrador)
• reg_update – registrador que realizó la última actualización
• created_date – fecha de creación
• updated_date – fecha de la última actualización
• transfer_date – fecha de transferencia a otro registrador
• tech_c – contacto técnico del NSSET
• dns – lista de servidores DNS
• servidor
  • name – nombre del servidor
  • addr_ipv4 – dirección IPv4 del servidor
  • addr_ipv6 – dirección IPv6 del servidor

Plantillas

Solicitud JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

Respuesta JSON (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

Utilice la nsset-create solicitud para crear un nuevo NSSET. El NSSET contiene una lista de servidores NS; cada servidor incluye una entrada de nombre y, opcionalmente, su dirección IP. También puede definir un contacto técnico; si no lo hace, se establecerá el predeterminado (WEDOS).

Parámetros

• tld – TLD
• name – nombre del NSSET
• dns – lista de servidores ns; cada entrada de servidor contiene la información de ese servidor ns
  • servidor
    • name – nombre (dirección de dominio)
    • addr_ipv4 – dirección IPv4
    • addr_ipv6 – dirección IPv6
• tech_c – contacto técnico – opcional

Valores devueltos

• 1000 = OK, NSSET creado
• 2201 = TLD introducido incorrecto
• 2210 = formato de los servidores ns no válido
• 2211 = demasiados servidores ns
• 2216 = sintaxis no válida en el contacto técnico 
• 2247 = formato de NSSET no admitido 
• 3228 = no se admite el trabajo con contactos
• 3229 = error al cargar el contacto
• 3242 = el NSSET no está disponible
• 3244 = error al crear el NSSET
• 3245 = el NSSET ya está registrado
• 3246 = no disponible
• 3247 = no disponible
• 3248 = no disponible – en cuarentena
• 3249 = no disponible – reservado
• 3250 = no disponible – bloqueado
• 3251 = ya registrado
• 4212 = error de conexión
• 4218 = error en la comprobación – error de comunicación
• 4219 = error en la creación – error de comunicación

Datos devueltos

Si se realiza correctamente, el comando devuelve en el nodo data:

• nsset – el nombre del NSSET creado

Plantillas

Solicitud JSON:

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

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-create",
    "data": {
      "nsset": "NSSET name"
    }
  }
}

---

nsset-update

Utilice la nsset-update solicitud para modificar un NSSET existente. La entrada anterior se sobrescribe por completo, así que introduzca todos los datos con cuidado.

Parámetros

• tld – TLD – obligatorio
• auth_info – AUTH-ID del NSSET – obligatorio
• name – nombre del NSSET – obligatorio
• dns – lista de servidores ns; cada entrada de servidor contiene la información de ese servidor ns – obligatorio
  • servidor – se requieren al menos 2
    • name – nombre de dominio del servidor – obligatorio
    • addr_ipv4 – dirección IPv4 – opcional
    • addr_ipv6 – dirección IPv6 – opcional
• tech_c – ID del contacto técnico – obligatorio

Valores devueltos

• 1000 = OK, NSSET modificado
• 2201 = TLD introducido incorrecto
• 2209 = error de sintaxis
• 2210 = formato de la lista de servidores dns no válido
• 2211 = demasiados servidores dns
• 2216 = sintaxis no válida en el contacto
• 2247 = NSSET no válido
• 3214 = error – NSSET no cargado
• 3228 = no se admite el trabajo con contactos
• 3229 = error al cargar el contacto
• 3242 = el NSSET no se admite para este dominio 
• 3252 = error de autorización
• 3254 = error al modificar el NSSET nsset
• 4204 = el NSSET no está disponible – error de conexión
• 4220 = error al modificar el NSSET – error de conexión
• 4212 = el contacto no está disponible – error de conexión

Datos devueltos

La solicitud no devuelve datos.

Plantillas

Solicitud JSON:

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

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-update"
  }
}

---

nsset-transfer

La nsset-transfer solicitud cambia el registrador del NSSET a WEDOS.

Parámetros

• tld – TLD
• name – nombre del NSSET
• auth_info – AUTH-ID del NSSET

Valores devueltos

• 1000 = OK
• 2100 = falta un parámetro obligatorio
• 2101 = parámetros de entrada no válidos
• 2201 = TLD no admitido
• 2209 = error de sintaxis
• 2215 = falta auth_info
• 2247 = nombre de NSSET no válido 
• 2249 = la transferencia del NSSET  no está permitida para este TLD
• 3214 = error – NSSET no cargado
• 3242 = NSSET no admitido
• 3251 = el NSSET ya está registrado con este registrador 
• 3255 = error de autorización
• 3256 = error al transferir el NSSET
• 4204 = NSSET no cargado – error de conexión
• 4221 = error al transferir el NSSET – error de conexión

Datos devueltos

La solicitud no devuelve datos.

Plantillas

Comando JSON:

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

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-transfer"
  }
}

---

nsset-send-auth-info

La nsset-send-auth-info solicitud envía el AUTH-ID del NSSET al correo electrónico del contacto técnico del NSSET.

Parámetros

• tld – TLD
• name – nombre del NSSET

Valores devueltos

• 1000 = OK, auth_info enviado al correo electrónico de contacto
• 2201 = TLD no admitido
• 2209 =  error de sintaxis del NSSET
• 2216 = error de sintaxis del contacto
• 2243 = para este NSSET no está permitido enviar el código de autorización
• 2247 = formato de NSSET no admitido
• 3214 = error – no se ha podido leer el NSSET
• 3217 = error al enviar el código de autorización
• 3228 = no se admite el trabajo con contactos
• 3229 = error al leer el contacto
• 3242 = el NSSET no está disponible
• 3257 = error al enviar, el NSSET no está disponible
• 4204 = el NSSET no está disponible – error de conexión
• 4212 = el contacto no está disponible – error de conexión
• 4222 = error al enviar – error de conexión

Datos devueltos

La solicitud no devuelve datos.

Plantillas

Solicitud JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-send-auth-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

Respuesta JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-send-auth-info"
  }
}