Dominios: rutas
Run Commands
El único punto de entrada para dominios de envío. Envía de 1 a 10 comandos en una petición y recibe un resultado por comando.
https://g.sendcorex.com/v1/domainMismo sobre que Contacts, Logs y Bounces & Complaints. Las páginas debajo de esta documentan cada comando.
Los errores se informan por comando. Un comando que falla no detiene a los demás, y el estado HTTP sigue siendo 200.
Los dominios se identifican por su nombre (acme.com), nunca por un id interno.
Parámetros del cuerpo
commandsobject[]obligatorioDe 1 a 10 comandos, ejecutados en orden. Todo el cuerpo puede ocupar hasta 1 MB.
commands[].commandstringobligatoriolist_domains,get_domain,add_domain,delete_domain,update_domain_description,list_free_domains,start_dkim_upgrade,cancel_dkim_upgrade,send_dns_instructionsorequest_domain_remediation.commands[].argsobjectopcionalLos argumentos del comando. Cualquier valor puede ser un
$refal resultado de un comando anterior.commands[].idstringopcionalTu propio identificador para el resultado. Por defecto, el índice (
"0","1"…). Obligatorio si quieres usar$ref.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/domain',
{
commands: [
{
command: "list_domains",
id: "mine"
},
{
command: "list_free_domains",
id: "free"
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
for (const result of response.data.results) {
if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
else console.log(result.id, result.data);
}Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "list_domains",
"id": "mine",
"type": "SUCCESS",
"took_ms": 6,
"data": {
"domains": [
{
"domain": "acme.com",
"validated": true,
"has_mx": true,
"has_spf": true,
"has_dkim": true,
"has_dmarc": true,
"has_return_path": true,
"description": "Transactional (app emails)",
"dkim_key_size": 2048,
"dkim_deprecated": false,
"dkim_upgrade_pending": false,
"created_at": "2026-09-02T14:21:07.118Z",
"updated_at": "2026-10-21T02:40:51.902Z"
}
]
}
},
{
"command": "list_free_domains",
"id": "free",
"type": "SUCCESS",
"took_ms": 0,
"data": {
"domains": [
"corexsend.com",
"inboxtaken.com",
"outsending.com",
"shieldhaus.uk",
"shieldhaus.info",
"mailverifypro.info",
"mailverifypro.online",
"mailverifypro.store",
"mailverifypro.org"
]
}
}
]
}Campos de la respuesta
typeSiempre
SUCCESScuando la petición en sí fue aceptada.results[].commandEl comando que produjo este resultado.
results[].idEl
idque enviaste, o el índice del comando.results[].typeSUCCESSoERROR.results[].took_msTiempo que tardó el comando dentro del servidor. Los comandos que comprueban el DNS tardan más.
results[].dataLa salida del comando. Solo está presente cuando
typeesSUCCESS.results[].code / messageEl error. Solo está presente cuando
typeesERROR.
Autenticación
Usa la API key que creas en el dashboard, en Developers → API Keys, con los scopes que necesitan los comandos.
AuthorizationEnvía
Authorization: <api key>oAuthorization: Bearer <api key>.domain:readlist_domains,get_domain,list_free_domainsysend_dns_instructions.domain:createadd_domain,start_dkim_upgrade,cancel_dkim_upgrade,update_domain_descriptionyrequest_domain_remediation.domain:deletedelete_domain. Dáselo solo a las claves que de verdad lo necesiten: eliminar un dominio también elimina sus senders.Tokens de buzónEl token del webmail no funciona aquí. Se rechaza con
WRONG_CREDENTIAL_TYPE.IPs permitidasSi la clave tiene una lista de IPs permitidas, las peticiones desde otras IPs reciben
403 IP_NOT_ALLOWED.
Encadenar con $ref
Añade un dominio y vuelve a leerlo en una petición: el segundo comando toma el dominio del primer resultado.
add_domain → get_domain
{
"commands": [
{
"command": "add_domain",
"id": "new",
"args": {
"domain": "acme.com"
}
},
{
"command": "get_domain",
"args": {
"domain": {
"$ref": "new",
"path": "domain"
}
}
}
]
}Límites de tasa
Dos límites. El primero es para toda la ruta, el segundo para algunos comandos.
15 peticiones / segundoPor IP + API key. Por encima, HTTP 429 con un header
Retry-After.15 simultáneasComo máximo 15 peticiones procesándose a la vez, por IP + API key.
Por comando, por cuentaadd_domain10/min ·get_domain60/min ·delete_domain30/min ·start_dkim_upgradeycancel_dkim_upgrade10/min ·update_domain_description20/min ·send_dns_instructionsyrequest_domain_remediation5/min. Por encima, ese comando respondeRATE_LIMITED.Sin cachéCada llamada lee la base de datos (y el DNS, en
get_domain). Lo que recibes siempre está actualizado.
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.
- 400
INVALID_JSONEl cuerpo no es {"commands":[...]} o pesa más de 1 MB.
- 400
INVALID_ARGSLa petición no tiene comandos o tiene más de 10.
- 401
MISSING_AUTH_HEADERNo se envió ningún header Authorization.
- 401
INVALID_API_KEYLa API key no existe, se revocó o se desactivó en el dashboard.
- 401
API_KEY_EXPIREDLa API key superó la fecha de caducidad definida en el dashboard.
- 401
WRONG_CREDENTIAL_TYPESe envió un token de buzón. La Domains API necesita una API key del dashboard.
- 403
IP_NOT_ALLOWEDLa petición vino de una IP que no está entre las IPs permitidas de la clave.
- 403
ACCOUNT_BLOCKEDLa cuenta está bloqueada.
- 403
MISSING_SCOPELa clave no tiene ningún scope `domain:*`, así que no se puede ejecutar ningún comando.
- 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.
- 503
AUTH_UNAVAILABLELa autenticación no está disponible temporalmente. Inténtalo de nuevo.
- CMD
UNKNOWN_COMMANDEl nombre del comando no existe.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.