Domains: Routen

Run Commands

Der einzige Einstiegspunkt für Versanddomains. Senden Sie 1 bis 10 Befehle in einem Request und erhalten Sie ein Ergebnis pro Befehl.

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

Gleiches Envelope wie Contacts, Logs und Bounces & Complaints. Die Seiten darunter dokumentieren jeden Befehl.

i

Fehler werden pro Befehl gemeldet. Ein fehlschlagender Befehl stoppt die anderen nicht, und der HTTP-Status bleibt 200.

i

Domains werden über ihren Namen (acme.com) identifiziert, nie über eine interne ID.

Body-Parameter

  • commandsobject[]erforderlich

    1 bis 10 Befehle, der Reihe nach ausgeführt. Der gesamte Body darf bis zu 1 MB groß sein.

  • commands[].commandstringerforderlich

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

  • commands[].argsobjectoptional

    Die Argumente des Befehls. Jeder Wert kann ein $ref auf das Ergebnis eines früheren Befehls sein.

  • commands[].idstringoptional

    Ihre eigene Kennung für das Ergebnis. Standard ist der Index ("0", "1" …). Pflicht, wenn Sie $ref verwenden möchten.

Schnellstart

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

Antwort

{
  "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"
        ]
      }
    }
  ]
}

Antwortfelder

  • type

    Immer SUCCESS, wenn der Request selbst angenommen wurde.

  • results[].command

    Der Befehl, der dieses Ergebnis erzeugt hat.

  • results[].id

    Die von Ihnen gesendete id oder der Index des Befehls.

  • results[].type

    SUCCESS oder ERROR.

  • results[].took_ms

    Zeit, die der Befehl im Server benötigt hat. Befehle, die den DNS prüfen, dauern länger.

  • results[].data

    Die Ausgabe des Befehls. Nur vorhanden, wenn type SUCCESS ist.

  • results[].code / message

    Der Fehler. Nur vorhanden, wenn type ERROR ist.

Authentifizierung

Verwenden Sie den API Key, den Sie im Dashboard unter Developers → API Keys erstellen, mit den Scopes, die die Befehle brauchen.

  • Authorization

    Senden Sie Authorization: <api key> oder Authorization: Bearer <api key>.

  • domain:read

    list_domains, get_domain, list_free_domains und send_dns_instructions.

  • domain:create

    add_domain, start_dkim_upgrade, cancel_dkim_upgrade, update_domain_description und request_domain_remediation.

  • domain:delete

    delete_domain. Vergeben Sie ihn nur an Schlüssel, die ihn wirklich brauchen: Das Löschen einer Domain löscht auch ihre Sender.

  • Mailbox-Tokens

    Das Webmail-Token funktioniert hier nicht. Es wird mit WRONG_CREDENTIAL_TYPE abgelehnt.

  • Erlaubte IPs

    Hat der Schlüssel eine IP-Allowlist, erhalten Requests von anderen IPs 403 IP_NOT_ALLOWED.

Verketten mit $ref

Fügen Sie eine Domain hinzu und lesen Sie sie in einem Request zurück: Der zweite Befehl übernimmt die Domain aus dem ersten Ergebnis.

add_domain → get_domain

{
  "commands": [
    {
      "command": "add_domain",
      "id": "new",
      "args": {
        "domain": "acme.com"
      }
    },
    {
      "command": "get_domain",
      "args": {
        "domain": {
          "$ref": "new",
          "path": "domain"
        }
      }
    }
  ]
}

Rate Limits

Zwei Limits. Das erste gilt für die ganze Route, das zweite für einige Befehle.

  • 15 Requests / Sekunde

    Pro IP + API Key. Darüber HTTP 429 mit einem Retry-After-Header.

  • 15 gleichzeitig

    Höchstens 15 Requests gleichzeitig in Bearbeitung, pro IP + API Key.

  • Pro Befehl, pro Konto

    add_domain 10/min · get_domain 60/min · delete_domain 30/min · start_dkim_upgrade und cancel_dkim_upgrade 10/min · update_domain_description 20/min · send_dns_instructions und request_domain_remediation 5/min. Darüber antwortet der Befehl mit RATE_LIMITED.

  • Kein Cache

    Jeder Aufruf liest die Datenbank (und bei get_domain den DNS). Was Sie erhalten, ist immer aktuell.

Fehler

Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.

  • 400INVALID_JSON

    Der Body ist nicht {"commands":[...]} oder größer als 1 MB.

  • 400INVALID_ARGS

    Der Request enthält keine Befehle oder mehr als 10.

  • 401MISSING_AUTH_HEADER

    Es wurde kein Authorization-Header gesendet.

  • 401INVALID_API_KEY

    Der API Key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.

  • 401API_KEY_EXPIRED

    Der API Key hat das im Dashboard festgelegte Ablaufdatum überschritten.

  • 401WRONG_CREDENTIAL_TYPE

    Es wurde ein Mailbox-Token gesendet. Die Domains API braucht einen API Key aus dem Dashboard.

  • 403IP_NOT_ALLOWED

    Der Request kam von einer IP, die nicht zu den erlaubten IPs des Schlüssels gehört.

  • 403ACCOUNT_BLOCKED

    Das Konto ist gesperrt.

  • 403MISSING_SCOPE

    Der Schlüssel hat keinen `domain:*`-Scope, daher kann kein Befehl laufen.

  • 429RATE_LIMITED

    Mehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API Key. Warten Sie die Sekunden aus Retry-After ab.

  • 503AUTH_UNAVAILABLE

    Die Authentifizierung ist vorübergehend nicht verfügbar. Versuchen Sie es erneut.

  • CMDUNKNOWN_COMMAND

    Der Befehlsname existiert nicht.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.