Dominios: ayuda de configuración

Solicitar corrección del dominio

Pide a nuestro equipo que revise un dominio que Add Domain rechazó con `BLACKLISTED`. Una vez aprobado, vuelve a añadirlo.

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

Necesita el scope domain:create en tu API key.

i

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

i

Una solicitud abierta por dominio. Respondemos por email.

Argumentos

  • domainstringobligatorio

    El dominio que se rechazó.

    p. ej. "acme.io"

  • justificationstringopcional

    Hasta 2000 caracteres. Cuéntanos para qué se usa el dominio y, si estaba listado, qué hiciste para salir de la lista.

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

Inicio 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);

Respuesta

{
  "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 de la respuesta

  • domain

    El dominio.

  • status

    Siempre pending aquí.

  • message

    Una frase que puedes mostrar a tu usuario.

De rechazado a añadido

  • 1. Rechazado

    Add Domain responde BLACKLISTED.

  • 2. Solicitud

    Este comando. Da todo el contexto que puedas.

  • 3. Aprobado

    Nuestro equipo lo revisa y te responde. Después vuelve a llamar a Add Domain: la comprobación de listas de bloqueo se omite para ese dominio en tu cuenta.

  • ¿Ya aprobado?

    Una nueva solicitud responde ALREADY_APPROVED: solo tienes que añadir el dominio.

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…

  • CMDALREADY_PENDING

    Ya hay una solicitud de remediación para este dominio pendiente de revisión.

  • CMDALREADY_APPROVED

    La remediación ya se aprobó: vuelve a añadir el dominio.

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