Domains: Einrichtungshilfe

Domain-Korrektur anfordern

Bittet unser Team, eine Domain zu prüfen, die Add Domain mit `BLACKLISTED` abgelehnt hat. Nach der Freigabe fügen Sie sie erneut hinzu.

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

Erfordert den Scope domain:create auf Ihrem API Key.

i

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

i

Eine offene Anfrage pro Domain. Wir antworten per E-Mail.

Argumente

  • domainstringerforderlich

    Die abgelehnte Domain.

    z. B. "acme.io"

  • justificationstringoptional

    Bis zu 2000 Zeichen. Erklären Sie, wofür die Domain genutzt wird und, falls sie gelistet war, was Sie für das Delisting getan haben.

    z. B. "New owner since August, previous site removed, delisted from Spamhaus on 2026-10-12."

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/domain',
  {
    commands: [
      {
        command: "request_domain_remediation",
        args: {
          domain: "acme.io",
          justification: "New owner since August, previous site removed, delisted from Spamhaus on 2026-10-12."
        }
      }
    ]
  },
  { 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": "request_domain_remediation",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 14,
      "data": {
        "domain": "acme.io",
        "status": "pending",
        "message": "Your request has been submitted. Our team will review it and contact you shortly."
      }
    }
  ]
}

Antwortfelder

  • domain

    Die Domain.

  • status

    Hier immer pending.

  • message

    Ein Satz, den Sie Ihrem Nutzer zeigen können.

Von abgelehnt zu hinzugefügt

  • 1. Abgelehnt

    Add Domain antwortet mit BLACKLISTED.

  • 2. Anfrage

    Dieser Befehl. Geben Sie so viel Kontext wie möglich.

  • 3. Freigegeben

    Unser Team prüft sie und meldet sich. Rufen Sie dann Add Domain erneut auf: Die Blocklisten-Prüfung wird für diese Domain in Ihrem Konto übersprungen.

  • Bereits freigegeben?

    Eine neue Anfrage antwortet mit ALREADY_APPROVED: Fügen Sie die Domain einfach hinzu.

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 …

  • CMDALREADY_PENDING

    Eine Remediation-Anfrage für diese Domain wartet bereits auf Prüfung.

  • CMDALREADY_APPROVED

    Die Remediation wurde bereits freigegeben: Fügen Sie die Domain erneut hinzu.

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