Módulo de DNS

Listar zonas

GET /v1/dns/zone

Devuelve todas las zonas (dominios) registradas en tu cuenta.

Respuesta

{
  "status": "ok",
  "count": 2,
  "zones": [
    {
      "key": 42,
      "name": "midominio.com",
      "status": 1,
      "primaryns": "ns1.webability.info",
      "adminemail": "dns.webability.info.",
      "serial": 2025070101,
      "refresh": 7200,
      "retry": 3600,
      "expire": 1209600,
      "minimum": 300,
      "defaultttl": 1800,
      "dnssec": 0,
      "creationdate": "2025-07-01T10:00:00Z"
    }
  ]
}

Ver zona y registros

GET /v1/dns/zone/{key}  también acepta nombre de dominio

Devuelve el detalle SOA de la zona y su lista completa de registros. Acepta la clave numérica o el nombre del dominio directamente.

Parámetros de ruta

Parámetro	Tipo	Descripción
key	INT o STRING	Clave numérica de la zona, o su nombre (p. ej. midominio.com)

Respuesta

{
  "status": "ok",
  "zone": { "key":42, "name":"midominio.com", "status":1, ... },
  "records": [
    { "key":101, "zone":42, "name":"@", "rrtype":1, "rrtypename":"A",
      "ttl":1800, "data":"1.2.3.4", "status":1, "priority":0 },
    { "key":102, "zone":42, "name":"www", "rrtype":5, "rrtypename":"CNAME",
      "ttl":1800, "data":"midominio.com.", "status":1, "priority":0 }
  ],
  "ns": ["ns1.webability.info", "ns2.webability.info"]
}

Crear zona

POST /v1/dns/zone

Registra un nuevo dominio en tu cuenta. Se generan automáticamente los registros NS apuntando a los servidores de Webability asignados a tu cuenta. Devuelve HTTP 201 en caso de éxito.

Body JSON

Campo	Tipo	Req.	Descripción
name	string	✓	Nombre del dominio (minúsculas, sin punto final). Ej: midominio.com

Ejemplo

POST /v1/dns/zone
Content-Type: application/json

{ "name": "midominio.com" }

Respuesta (201 Created)

{ "status": "ok", "key": 42, "name": "midominio.com" }

Eliminar zona

DELETE /v1/dns/zone/{key}

Elimina la zona y todos sus registros. Esta operación es irreversible. Se envía un correo de notificación al titular de la cuenta con los datos completos de la zona eliminada.

Parámetros de ruta

Parámetro	Tipo	Descripción
key	INT	Clave numérica de la zona

Respuesta (200 OK)

{ "status": "ok", "key": 42, "name": "midominio.com" }

Agregar registro

POST /v1/dns/zone/{key}/record

Crea un registro DNS dentro de la zona indicada. Devuelve HTTP 201 en caso de éxito.

Parámetros de ruta

Parámetro	Tipo	Descripción
key	INT	Clave de la zona donde se crea el registro

Body JSON

Campo	Tipo	Req.	Descripción
name	string	✓	Nombre del registro. Usa @ para el apex (raíz del dominio).
rrtype	string	✓	Tipo IANA: A, AAAA, MX, CNAME, TXT, NS, SRV, CAA, etc. También acepta código decimal.
ttl	int	–	Time-to-live en segundos. 0 usa el TTL por defecto de la zona (1800 s).
data	string	✓	RDATA en sintaxis de zona. Ver tipos de registros.
priority	int	–	Prioridad. Requerido para MX, SRV, SVCB, HTTPS.
weight	int	–	Peso (SRV).
port	int	–	Puerto (SRV).
tag	string	–	Etiqueta (CAA): issue, issuewild, iodef.

Ejemplos

Registro A (IP del servidor):

POST /v1/dns/zone/42/record
{ "name":"@", "rrtype":"A", "ttl":1800, "data":"1.2.3.4" }

Correo (MX):

{ "name":"@", "rrtype":"MX", "ttl":3600, "data":"mail.midominio.com.", "priority":10 }

Verificación de dominio (TXT):

{ "name":"@", "rrtype":"TXT", "ttl":300, "data":"v=spf1 include:_spf.midominio.com ~all" }

Subdominio (CNAME):

{ "name":"www", "rrtype":"CNAME", "ttl":1800, "data":"midominio.com." }

Respuesta (201 Created)

{ "status": "ok", "key": 101, "zone": 42 }

Modificar registro

PUT /v1/dns/record/{key}

Actualiza uno o más campos de un registro. Solo se modifican los campos que se envían; los campos omitidos conservan su valor actual.

Body JSON (todos opcionales)

Campo	Tipo	Descripción
name	string	Nuevo nombre del registro
ttl	int	Nuevo TTL en segundos
data	string	Nuevo valor RDATA
priority	int	Nueva prioridad (MX, SRV…)
weight	int	Nuevo peso (SRV)
port	int	Nuevo puerto (SRV)
tag	string	Nueva etiqueta (CAA)
status	int	1 = activo, 0 = inactivo

Ejemplo — cambiar la IP de un registro A

PUT /v1/dns/record/101
{ "data": "5.6.7.8" }

Respuesta (200 OK)

{ "status": "ok", "key": 101 }

Eliminar registro

DELETE /v1/dns/record/{key}

Elimina un registro de la zona. La clave de registro se obtiene de la respuesta de GET /v1/dns/zone/{key}.

Respuesta (200 OK)

{ "status": "ok", "key": 101 }