Domains: DKIM

DKIM-Upgrade starten

Stellt eine Domain von einem 1024-Bit- auf einen 2048-Bit-DKIM-Schlüssel um, ohne Ihre Sendungen zu stoppen. Erzeugt den neuen Schlüssel auf einem neuen Selector und gibt den zu veröffentlichenden Eintrag zurück.

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

Erfordert den Scope domain:create auf Ihrem API Key.

i

Bis zu 10 Aufrufe pro Minute und Konto. Darüber antwortet der Befehl mit RATE_LIMITED.

i

Kann gefahrlos zweimal aufgerufen werden: Läuft bereits ein Upgrade, erhalten Sie denselben ausstehenden Schlüssel zurück.

!

Bearbeiten oder entfernen Sie den aktuellen DKIM-Eintrag nicht. Fügen Sie den neuen daneben hinzu.

Argumente

  • domainstringerforderlich

    Der Domainname.

    z. B. "acme-mail.com"

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/domain',
  {
    commands: [
      {
        command: "start_dkim_upgrade",
        args: {
          domain: "acme-mail.com"
        }
      }
    ]
  },
  { 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);

Antwort

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "start_dkim_upgrade",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 620,
      "data": {
        "domain": "acme-mail.com",
        "validated": true,
        "has_mx": true,
        "has_spf": true,
        "has_dkim": true,
        "has_dmarc": true,
        "has_return_path": true,
        "description": null,
        "dkim_key_size": 1024,
        "dkim_deprecated": true,
        "dkim_upgrade_pending": true,
        "created_at": "2026-09-02T14:21:07.118Z",
        "updated_at": "2026-10-21T02:40:51.902Z",
        "registrar": "cloudflare",
        "dns_records": {
          "spf": {
            "type": "TXT",
            "host": "acme-mail.com",
            "value": "v=spf1 include:_spf.google.com include:smtp.emailsbit.com ~all"
          },
          "dkim": {
            "type": "TXT",
            "host": "sendcorex._domainkey",
            "value": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDCfGv4Yz2sTJHJ7BwjYjLlcHpL1OVJ0eA6Gg3Z3sQhZ2y1nI4S0Zl8q7vUJr5cQ1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7A8B9C0D1E2F3G4H5I6J7K8L9M0N1O2P3Q4R5S6T7U8V9W0X1Y2Z3wIDAQAB"
          },
          "dkim_pending": {
            "type": "TXT",
            "host": "sendcorex2._domainkey",
            "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB",
            "split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6\" \"jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB\""
          },
          "mx": {
            "type": "MX",
            "host": "acme-mail.com",
            "value": "bounce.emailsbit.com",
            "priority": 0
          },
          "return_path": {
            "type": "CNAME",
            "host": "bounces",
            "value": "bounce.emailsbit.com"
          },
          "dmarc": {
            "type": "TXT",
            "host": "_dmarc",
            "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@bounces.acme-mail.com"
          }
        },
        "spf_duplicate": false,
        "spf_duplicate_records": [],
        "dkim": {
          "version": 1,
          "key_size": 1024,
          "selector": "sendcorex",
          "deprecated": true,
          "upgrade_pending": true,
          "pending": {
            "selector": "sendcorex2",
            "key_size": 2048,
            "host": "sendcorex2._domainkey",
            "full_host": "sendcorex2._domainkey.acme-mail.com",
            "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB",
            "split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6\" \"jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB\"",
            "created_at": "2026-10-21T03:10:44.205Z"
          },
          "previous_selector": null,
          "keep_old_record_until": null,
          "just_upgraded": false
        }
      }
    }
  ]
}

Antwortfelder

  • domain

    Der Domainname, kleingeschrieben. Das ist die ID, die Sie in allen anderen Befehlen verwenden.

  • validated

    true, sobald der Return-Path-CNAME und der DKIM-Eintrag gefunden wurden. Nur validierte Domains können Sender haben.

  • has_mx

    Der MX-Eintrag zeigt auf bounce.emailsbit.com. Optional: nur nötig, um Antworten und Bounces auf der Domain selbst zu empfangen.

  • has_spf

    Ihr SPF enthält include:smtp.emailsbit.com.

  • has_dkim

    Der DKIM-TXT-Eintrag mit Ihrem öffentlichen Schlüssel ist veröffentlicht.

  • has_dmarc

    Auf _dmarc.<domain> existiert ein DMARC-Eintrag.

  • has_return_path

    Der Return-Path-CNAME (bounces.<domain> → bounce.emailsbit.com) ist veröffentlicht. Bounces und SPF-Alignment hängen davon ab.

  • description

    Ihre eigene Notiz zur Domain oder null.

  • dkim_key_size

    2048 oder 1024. null, wenn die Domain noch keinen Schlüssel hat.

  • dkim_deprecated

    true bei 1024-Bit-Schlüsseln. Einige Anbieter stufen sie bereits als schwach ein: Führen Sie ein Upgrade mit Start DKIM Upgrade durch.

  • dkim_upgrade_pending

    true, solange ein neuer 2048-Bit-Schlüssel auf seinen DNS-Eintrag wartet.

  • created_at / updated_at

    ISO 8601, UTC.

  • registrar

    Wo der DNS gehostet wird, anhand der Nameserver: cloudflare, namecheap, godaddy, route53, google, vercel, hostinger, ionos, hetzner, dreamhost, squarespace, registrobr oder other.

  • dns_records.spf / dkim / mx / return_path / dmarc

    Die zu veröffentlichenden Einträge. Jeder hat type, host und value. Siehe DNS-Einträge unten.

  • dns_records.dkim_pending

    Nur während eines DKIM-Upgrades: der neue 2048-Bit-Eintrag. Veröffentlichen Sie ihn neben dem aktuellen.

  • dns_records.*.split_value

    Nur für TXT-Werte über 255 Zeichen: derselbe Wert, bereits in Strings in Anführungszeichen aufgeteilt, für DNS-Panels, die das brauchen.

  • dns_records.mx.priority

    Immer 0.

  • spf_duplicate

    true, wenn die Domain mehr als einen SPF-Eintrag hat. Das ist ungültig: SPF schlägt bei jedem Empfänger fehl, bis Sie sie zu einem zusammenführen.

  • spf_duplicate_records

    Die gefundenen SPF-Einträge, damit Sie sie zusammenführen können.

  • dkim

    Der verwendete DKIM-Schlüssel und ein eventuell laufendes Upgrade. Siehe DKIM unten.

  • dkim.version

    2 für 2048-Bit-Schlüssel, 1 für 1024.

  • dkim.key_size

    Die Größe des Schlüssels, der Ihre E-Mails derzeit signiert.

  • dkim.selector

    Der Selector des verwendeten Schlüssels: das s= im DKIM-Signature-Header.

  • dkim.deprecated

    true bei 1024-Bit-Schlüsseln.

  • dkim.upgrade_pending

    true, solange ein neuer Schlüssel auf seinen DNS-Eintrag wartet.

  • dkim.pending

    Der neue Schlüssel: selector, key_size, host, full_host, value, split_value, created_at. null, wenn kein Upgrade läuft.

  • dkim.previous_selector

    48 Stunden nach einem Upgrade: der alte Selector. Behalten Sie seinen Eintrag bis keep_old_record_until, danach können Sie ihn entfernen.

  • dkim.keep_old_record_until

    Wann der alte Eintrag entfernt werden kann. null, wenn nichts zu entfernen ist.

  • dkim.just_upgraded

    true nur bei dem Aufruf, der auf den neuen Schlüssel umgeschaltet hat.

So funktioniert das Upgrade

Ihre E-Mails werden die ganze Zeit mit dem alten Schlüssel signiert, bis der neue im DNS steht.

  • 1. Starten

    Dieser Befehl. Der neue Schlüssel landet in dkim.pending und dns_records.dkim_pending (Selector sendcorex2).

  • 2. Veröffentlichen

    Legen Sie den TXT-Eintrag dkim_pending an. Behalten Sie den alten.

  • 3. Prüfen

    Rufen Sie Get Domain auf. Sobald der neue Eintrag gefunden wird, signiert der neue Schlüssel (dkim.just_upgraded ist bei diesem Aufruf true).

  • 4. Aufräumen

    Behalten Sie den alten Eintrag bis dkim.keep_old_record_until (48 Stunden), damit noch unterwegs befindliche E-Mails weiter bestehen, und entfernen Sie ihn dann.

Fehler

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

  • 401INVALID_API_KEY

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

  • 429RATE_LIMITED

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

  • CMDMISSING_SCOPE

    Dem API Key fehlt der Scope, den dieser Befehl braucht.

  • CMDINVALID_ARGS

    Ein Argument ist ungültig: fehlende oder fehlerhafte `domain`, `key_size` ungleich 1024/2048, ungültige `email`, eine Beschreibung über 255 Zeichen …

  • CMDDOMAIN_NOT_FOUND

    Die Domain ist nicht in Ihrem Konto.

  • CMDDKIM_NOT_FOUND

    Die Domain hat keinen DKIM-Schlüssel.

  • CMDALREADY_UPGRADED

    Die Domain verwendet bereits einen 2048-Bit-Schlüssel.

  • CMDDKIM_GENERATION_FAILED

    Der DKIM-Schlüssel konnte nicht erzeugt werden. Es wurde nichts gespeichert. Versuchen Sie es erneut.

  • CMDRATE_LIMITED

    Dieser Befehl wurde in der letzten Minute zu oft von Ihrem Konto aufgerufen. Warten Sie eine Minute.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.