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.

POSThttps://g.sendcorex.com/v1/domaincommand: send_dns_instructions
i

Necesita el scope domain:read en tu API key.

i

Hasta 5 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.

i

Durante una actualización de DKIM, el email incluye el registro nuevo (el que aún falta), no el actual.

Argumentos

  • domainstringobligatorio

    El nombre del dominio.

    p. ej. "acme.com"

  • emailstringobligatorio

    Quié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

  • domain

    El dominio.

  • sent_to

    La dirección a la que se envió el email.

Qué incluye el email

  • Registros

    SPF, DKIM, Return-Path y DMARC, con nombre y valor listos para copiar.

  • Remitente

    El 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.

  • 401INVALID_API_KEY

    La API key no existe, se revocó o se desactivó en el dashboard.

  • 429RATE_LIMITED

    Más de 15 peticiones/s o 15 simultáneas para la misma IP + API key. Espera los segundos indicados en Retry-After.

  • CMDMISSING_SCOPE

    La API key no tiene el scope que necesita este comando.

  • CMDINVALID_ARGS

    Un 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…

  • CMDDOMAIN_NOT_FOUND

    El dominio no está en tu cuenta.

  • CMDSEND_FAILED

    No se pudo enviar el email de instrucciones. Inténtalo de nuevo.

  • CMDUSER_NOT_FOUND

    La cuenta de la API key ya no existe.

  • CMDRATE_LIMITED

    Tu cuenta llamó a este comando demasiadas veces en el último minuto. Espera un minuto.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.