Dominios: ayuda de configuración
Enviar instrucciones de DNS
Envía por email los registros DNS de un dominio a quien gestiona tu DNS: tu equipo de TI, una agencia, un freelance.
https://g.sendcorex.com/v1/domaincommand: send_dns_instructionsNecesita el scope domain:read en tu API key.
Hasta 5 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.
Durante una actualización de DKIM, el email incluye el registro nuevo (el que aún falta), no el actual.
Argumentos
domainstringobligatorioEl nombre del dominio.
p. ej.
"acme.com"emailstringobligatorioQuién recibe las instrucciones. Hasta 255 caracteres.
p. ej.
"it@acme.com"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/domain',
{
commands: [
{
command: "send_dns_instructions",
args: {
domain: "acme.com",
email: "it@acme.com"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "send_dns_instructions",
"id": "0",
"type": "SUCCESS",
"took_ms": 910,
"data": {
"domain": "acme.com",
"sent_to": "it@acme.com"
}
}
]
}Campos de la respuesta
domainEl dominio.
sent_toLa dirección a la que se envió el email.
Qué incluye el email
RegistrosSPF, DKIM, Return-Path y DMARC, con nombre y valor listos para copiar.
RemitenteEl nombre de tu cuenta, para que la persona sepa quién lo pidió.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, se revocó o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 15 peticiones/s o 15 simultáneas para la misma IP + API key. Espera los segundos indicados en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene el scope que necesita este comando.
- CMD
INVALID_ARGSUn argumento no es válido: `domain` ausente o con formato incorrecto, `key_size` distinto de 1024/2048, `email` inválido, una descripción de más de 255 caracteres…
- CMD
DOMAIN_NOT_FOUNDEl dominio no está en tu cuenta.
- CMD
SEND_FAILEDNo se pudo enviar el email de instrucciones. Inténtalo de nuevo.
- CMD
USER_NOT_FOUNDLa cuenta de la API key ya no existe.
- CMD
RATE_LIMITEDTu cuenta llamó a este comando demasiadas veces en el último minuto. Espera un minuto.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.