Domínios: ajuda na configuração

Enviar instruções de DNS

Envia por email os registros DNS de um domínio para quem gerencia seu DNS: seu time de TI, uma agência, um freelancer.

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

Precisa do scope domain:read na sua API key.

i

Até 5 chamadas por minuto por conta. Acima disso, o comando responde RATE_LIMITED.

i

Durante um upgrade de DKIM, o email traz o registro novo (o que ainda falta), não o atual.

Argumentos

  • domainstringobrigatório

    O nome do domínio.

    ex.: "acme.com"

  • emailstringobrigatório

    Quem recebe as instruções. Até 255 caracteres.

    ex.: "it@acme.com"

Início 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);

Resposta

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "send_dns_instructions",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 910,
      "data": {
        "domain": "acme.com",
        "sent_to": "it@acme.com"
      }
    }
  ]
}

Campos da resposta

  • domain

    O domínio.

  • sent_to

    O endereço para o qual o email foi enviado.

O que o email traz

  • Registros

    SPF, DKIM, Return-Path e DMARC, com nome e valor prontos para copiar.

  • Remetente

    O nome da sua conta, para a pessoa saber quem pediu.

Erros

Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.

  • 401INVALID_API_KEY

    A API key não existe, foi revogada ou foi desativada no dashboard.

  • 429RATE_LIMITED

    Mais de 15 requests/s ou 15 simultâneos para o mesmo IP + API key. Espere o número de segundos em Retry-After.

  • CMDMISSING_SCOPE

    A API key não tem o scope que este comando precisa.

  • CMDINVALID_ARGS

    Um argumento é inválido: `domain` ausente ou malformado, `key_size` diferente de 1024/2048, `email` inválido, uma descrição com mais de 255 caracteres…

  • CMDDOMAIN_NOT_FOUND

    O domínio não está na sua conta.

  • CMDSEND_FAILED

    O email de instruções não pôde ser enviado. Tente de novo.

  • CMDUSER_NOT_FOUND

    A conta da API key não existe mais.

  • CMDRATE_LIMITED

    Este comando foi chamado vezes demais no último minuto pela sua conta. Espere um minuto.

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.