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.
https://g.sendcorex.com/v1/domaincommand: start_dkim_upgradeErfordert den Scope domain:create auf Ihrem API Key.
Bis zu 10 Aufrufe pro Minute und Konto. Darüber antwortet der Befehl mit RATE_LIMITED.
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
domainstringerforderlichDer 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
domainDer Domainname, kleingeschrieben. Das ist die ID, die Sie in allen anderen Befehlen verwenden.
validatedtrue, sobald der Return-Path-CNAME und der DKIM-Eintrag gefunden wurden. Nur validierte Domains können Sender haben.has_mxDer MX-Eintrag zeigt auf
bounce.emailsbit.com. Optional: nur nötig, um Antworten und Bounces auf der Domain selbst zu empfangen.has_spfIhr SPF enthält
include:smtp.emailsbit.com.has_dkimDer DKIM-TXT-Eintrag mit Ihrem öffentlichen Schlüssel ist veröffentlicht.
has_dmarcAuf
_dmarc.<domain>existiert ein DMARC-Eintrag.has_return_pathDer Return-Path-CNAME (
bounces.<domain>→bounce.emailsbit.com) ist veröffentlicht. Bounces und SPF-Alignment hängen davon ab.descriptionIhre eigene Notiz zur Domain oder
null.dkim_key_size2048oder1024.null, wenn die Domain noch keinen Schlüssel hat.dkim_deprecatedtruebei 1024-Bit-Schlüsseln. Einige Anbieter stufen sie bereits als schwach ein: Führen Sie ein Upgrade mit Start DKIM Upgrade durch.dkim_upgrade_pendingtrue, solange ein neuer 2048-Bit-Schlüssel auf seinen DNS-Eintrag wartet.created_at / updated_atISO 8601, UTC.
registrarWo der DNS gehostet wird, anhand der Nameserver:
cloudflare,namecheap,godaddy,route53,google,vercel,hostinger,ionos,hetzner,dreamhost,squarespace,registrobroderother.dns_records.spf / dkim / mx / return_path / dmarcDie zu veröffentlichenden Einträge. Jeder hat
type,hostundvalue. Siehe DNS-Einträge unten.dns_records.dkim_pendingNur während eines DKIM-Upgrades: der neue 2048-Bit-Eintrag. Veröffentlichen Sie ihn neben dem aktuellen.
dns_records.*.split_valueNur 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.priorityImmer
0.spf_duplicatetrue, 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_recordsDie gefundenen SPF-Einträge, damit Sie sie zusammenführen können.
dkimDer verwendete DKIM-Schlüssel und ein eventuell laufendes Upgrade. Siehe DKIM unten.
dkim.version2für 2048-Bit-Schlüssel,1für 1024.dkim.key_sizeDie Größe des Schlüssels, der Ihre E-Mails derzeit signiert.
dkim.selectorDer Selector des verwendeten Schlüssels: das
s=im DKIM-Signature-Header.dkim.deprecatedtruebei 1024-Bit-Schlüsseln.dkim.upgrade_pendingtrue, solange ein neuer Schlüssel auf seinen DNS-Eintrag wartet.dkim.pendingDer neue Schlüssel:
selector,key_size,host,full_host,value,split_value,created_at.null, wenn kein Upgrade läuft.dkim.previous_selector48 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_untilWann der alte Eintrag entfernt werden kann.
null, wenn nichts zu entfernen ist.dkim.just_upgradedtruenur 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. StartenDieser Befehl. Der neue Schlüssel landet in
dkim.pendingunddns_records.dkim_pending(Selectorsendcorex2).2. VeröffentlichenLegen Sie den TXT-Eintrag
dkim_pendingan. Behalten Sie den alten.3. PrüfenRufen Sie Get Domain auf. Sobald der neue Eintrag gefunden wird, signiert der neue Schlüssel (
dkim.just_upgradedist bei diesem Aufruftrue).4. AufräumenBehalten 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.
- 401
INVALID_API_KEYDer API Key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API Key. Warten Sie die Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDem API Key fehlt der Scope, den dieser Befehl braucht.
- CMD
INVALID_ARGSEin Argument ist ungültig: fehlende oder fehlerhafte `domain`, `key_size` ungleich 1024/2048, ungültige `email`, eine Beschreibung über 255 Zeichen …
- CMD
DOMAIN_NOT_FOUNDDie Domain ist nicht in Ihrem Konto.
- CMD
DKIM_NOT_FOUNDDie Domain hat keinen DKIM-Schlüssel.
- CMD
ALREADY_UPGRADEDDie Domain verwendet bereits einen 2048-Bit-Schlüssel.
- CMD
DKIM_GENERATION_FAILEDDer DKIM-Schlüssel konnte nicht erzeugt werden. Es wurde nichts gespeichert. Versuchen Sie es erneut.
- CMD
RATE_LIMITEDDieser Befehl wurde in der letzten Minute zu oft von Ihrem Konto aufgerufen. Warten Sie eine Minute.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.