Domínios: ajuda na configuração

Solicitar correção do domínio

Pede ao nosso time que revise um domínio que Add Domain recusou com `BLACKLISTED`. Depois de aprovado, adicione de novo.

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

Precisa do scope domain:create na sua API key.

i

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

i

Um pedido aberto por domínio. Respondemos por email.

Argumentos

  • domainstringobrigatório

    O domínio que foi recusado.

    ex.: "acme.io"

  • justificationstringopcional

    Até 2000 caracteres. Conte para que o domínio é usado e, se ele estava listado, o que você fez para sair da lista.

    ex.: "New owner since August, previous site removed, delisted from Spamhaus on 2026-10-12."

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/domain',
  {
    commands: [
      {
        command: "request_domain_remediation",
        args: {
          domain: "acme.io",
          justification: "New owner since August, previous site removed, delisted from Spamhaus on 2026-10-12."
        }
      }
    ]
  },
  { 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": "request_domain_remediation",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 14,
      "data": {
        "domain": "acme.io",
        "status": "pending",
        "message": "Your request has been submitted. Our team will review it and contact you shortly."
      }
    }
  ]
}

Campos da resposta

  • domain

    O domínio.

  • status

    Sempre pending aqui.

  • message

    Uma frase que você pode mostrar ao seu usuário.

De recusado a adicionado

  • 1. Recusado

    Add Domain responde BLACKLISTED.

  • 2. Pedido

    Este comando. Dê o máximo de contexto que puder.

  • 3. Aprovado

    Nosso time revisa e responde. Depois chame Add Domain de novo: a verificação de blocklist é pulada para esse domínio na sua conta.

  • Já aprovado?

    Um novo pedido responde ALREADY_APPROVED: é só adicionar o domínio.

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…

  • CMDALREADY_PENDING

    Um pedido de remediação para este domínio já está aguardando revisão.

  • CMDALREADY_APPROVED

    A remediação já foi aprovada: adicione o domínio de novo.

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