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.
https://g.sendcorex.com/v1/domainGleiches Envelope wie Contacts, Logs und Bounces & Complaints. Die Seiten darunter dokumentieren jeden Befehl.
Fehler werden pro Befehl gemeldet. Ein fehlschlagender Befehl stoppt die anderen nicht, und der HTTP-Status bleibt 200.
Domains werden über ihren Namen (acme.com) identifiziert, nie über eine interne ID.
Body-Parameter
commandsobject[]erforderlich1 bis 10 Befehle, der Reihe nach ausgeführt. Der gesamte Body darf bis zu 1 MB groß sein.
commands[].commandstringerforderlichlist_domains,get_domain,add_domain,delete_domain,update_domain_description,list_free_domains,start_dkim_upgrade,cancel_dkim_upgrade,send_dns_instructionsoderrequest_domain_remediation.commands[].argsobjectoptionalDie Argumente des Befehls. Jeder Wert kann ein
$refauf das Ergebnis eines früheren Befehls sein.commands[].idstringoptionalIhre eigene Kennung für das Ergebnis. Standard ist der Index (
"0","1"…). Pflicht, wenn Sie$refverwenden 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
typeImmer
SUCCESS, wenn der Request selbst angenommen wurde.results[].commandDer Befehl, der dieses Ergebnis erzeugt hat.
results[].idDie von Ihnen gesendete
idoder der Index des Befehls.results[].typeSUCCESSoderERROR.results[].took_msZeit, die der Befehl im Server benötigt hat. Befehle, die den DNS prüfen, dauern länger.
results[].dataDie Ausgabe des Befehls. Nur vorhanden, wenn
typeSUCCESSist.results[].code / messageDer Fehler. Nur vorhanden, wenn
typeERRORist.
Authentifizierung
Verwenden Sie den API Key, den Sie im Dashboard unter Developers → API Keys erstellen, mit den Scopes, die die Befehle brauchen.
AuthorizationSenden Sie
Authorization: <api key>oderAuthorization: Bearer <api key>.domain:readlist_domains,get_domain,list_free_domainsundsend_dns_instructions.domain:createadd_domain,start_dkim_upgrade,cancel_dkim_upgrade,update_domain_descriptionundrequest_domain_remediation.domain:deletedelete_domain. Vergeben Sie ihn nur an Schlüssel, die ihn wirklich brauchen: Das Löschen einer Domain löscht auch ihre Sender.Mailbox-TokensDas Webmail-Token funktioniert hier nicht. Es wird mit
WRONG_CREDENTIAL_TYPEabgelehnt.Erlaubte IPsHat 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 / SekundePro IP + API Key. Darüber HTTP 429 mit einem
Retry-After-Header.15 gleichzeitigHöchstens 15 Requests gleichzeitig in Bearbeitung, pro IP + API Key.
Pro Befehl, pro Kontoadd_domain10/min ·get_domain60/min ·delete_domain30/min ·start_dkim_upgradeundcancel_dkim_upgrade10/min ·update_domain_description20/min ·send_dns_instructionsundrequest_domain_remediation5/min. Darüber antwortet der Befehl mitRATE_LIMITED.Kein CacheJeder Aufruf liest die Datenbank (und bei
get_domainden 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.
- 400
INVALID_JSONDer Body ist nicht {"commands":[...]} oder größer als 1 MB.
- 400
INVALID_ARGSDer Request enthält keine Befehle oder mehr als 10.
- 401
MISSING_AUTH_HEADEREs wurde kein Authorization-Header gesendet.
- 401
INVALID_API_KEYDer API Key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 401
API_KEY_EXPIREDDer API Key hat das im Dashboard festgelegte Ablaufdatum überschritten.
- 401
WRONG_CREDENTIAL_TYPEEs wurde ein Mailbox-Token gesendet. Die Domains API braucht einen API Key aus dem Dashboard.
- 403
IP_NOT_ALLOWEDDer Request kam von einer IP, die nicht zu den erlaubten IPs des Schlüssels gehört.
- 403
ACCOUNT_BLOCKEDDas Konto ist gesperrt.
- 403
MISSING_SCOPEDer Schlüssel hat keinen `domain:*`-Scope, daher kann kein Befehl laufen.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API Key. Warten Sie die Sekunden aus Retry-After ab.
- 503
AUTH_UNAVAILABLEDie Authentifizierung ist vorübergehend nicht verfügbar. Versuchen Sie es erneut.
- CMD
UNKNOWN_COMMANDDer Befehlsname existiert nicht.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.