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.
https://g.sendcorex.com/v1/domaincommand: request_domain_remediationNecesita el scope domain:create en tu API key.
Hasta 5 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.
Una solicitud abierta por dominio. Respondemos por email.
Argumentos
domainstringobligatorioEl dominio que se rechazó.
p. ej.
"acme.io"justificationstringopcionalHasta 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
domainEl dominio.
statusSiempre
pendingaquí.messageUna frase que puedes mostrar a tu usuario.
De rechazado a añadido
1. RechazadoAdd Domain responde
BLACKLISTED.2. SolicitudEste comando. Da todo el contexto que puedas.
3. AprobadoNuestro 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.
- 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
ALREADY_PENDINGYa hay una solicitud de remediación para este dominio pendiente de revisión.
- CMD
ALREADY_APPROVEDLa remediación ya se aprobó: vuelve a añadir el dominio.
- 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.