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.

POSThttps://g.sendcorex.com/v1/domain
i

Mismo sobre que Contacts, Logs y Bounces & Complaints. Las páginas debajo de esta documentan cada comando.

i

Los errores se informan por comando. Un comando que falla no detiene a los demás, y el estado HTTP sigue siendo 200.

i

Los dominios se identifican por su nombre (acme.com), nunca por un id interno.

Parámetros del cuerpo

  • commandsobject[]obligatorio

    De 1 a 10 comandos, ejecutados en orden. Todo el cuerpo puede ocupar hasta 1 MB.

  • commands[].commandstringobligatorio

    list_domains, get_domain, add_domain, delete_domain, update_domain_description, list_free_domains, start_dkim_upgrade, cancel_dkim_upgrade, send_dns_instructions o request_domain_remediation.

  • commands[].argsobjectopcional

    Los argumentos del comando. Cualquier valor puede ser un $ref al resultado de un comando anterior.

  • commands[].idstringopcional

    Tu 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

  • type

    Siempre SUCCESS cuando la petición en sí fue aceptada.

  • results[].command

    El comando que produjo este resultado.

  • results[].id

    El id que enviaste, o el índice del comando.

  • results[].type

    SUCCESS o ERROR.

  • results[].took_ms

    Tiempo que tardó el comando dentro del servidor. Los comandos que comprueban el DNS tardan más.

  • results[].data

    La salida del comando. Solo está presente cuando type es SUCCESS.

  • results[].code / message

    El error. Solo está presente cuando type es ERROR.

Autenticación

Usa la API key que creas en el dashboard, en Developers → API Keys, con los scopes que necesitan los comandos.

  • Authorization

    Envía Authorization: <api key> o Authorization: Bearer <api key>.

  • domain:read

    list_domains, get_domain, list_free_domains y send_dns_instructions.

  • domain:create

    add_domain, start_dkim_upgrade, cancel_dkim_upgrade, update_domain_description y request_domain_remediation.

  • domain:delete

    delete_domain. Dáselo solo a las claves que de verdad lo necesiten: eliminar un dominio también elimina sus senders.

  • Tokens de buzón

    El token del webmail no funciona aquí. Se rechaza con WRONG_CREDENTIAL_TYPE.

  • IPs permitidas

    Si 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 / segundo

    Por IP + API key. Por encima, HTTP 429 con un header Retry-After.

  • 15 simultáneas

    Como máximo 15 peticiones procesándose a la vez, por IP + API key.

  • Por comando, por cuenta

    add_domain 10/min · get_domain 60/min · delete_domain 30/min · start_dkim_upgrade y cancel_dkim_upgrade 10/min · update_domain_description 20/min · send_dns_instructions y request_domain_remediation 5/min. Por encima, ese comando responde RATE_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.

  • 400INVALID_JSON

    El cuerpo no es {"commands":[...]} o pesa más de 1 MB.

  • 400INVALID_ARGS

    La petición no tiene comandos o tiene más de 10.

  • 401MISSING_AUTH_HEADER

    No se envió ningún header Authorization.

  • 401INVALID_API_KEY

    La API key no existe, se revocó o se desactivó en el dashboard.

  • 401API_KEY_EXPIRED

    La API key superó la fecha de caducidad definida en el dashboard.

  • 401WRONG_CREDENTIAL_TYPE

    Se envió un token de buzón. La Domains API necesita una API key del dashboard.

  • 403IP_NOT_ALLOWED

    La petición vino de una IP que no está entre las IPs permitidas de la clave.

  • 403ACCOUNT_BLOCKED

    La cuenta está bloqueada.

  • 403MISSING_SCOPE

    La clave no tiene ningún scope `domain:*`, así que no se puede ejecutar ningún comando.

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

  • 503AUTH_UNAVAILABLE

    La autenticación no está disponible temporalmente. Inténtalo de nuevo.

  • CMDUNKNOWN_COMMAND

    El nombre del comando no existe.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.