Templates: Bearbeiten

Template löschen

Entfernt ein html-Template und alle seine Versionen.

POSThttps://g.sendcorex.com/v1/templatecommand: delete_template
i

Erfordert den Scope template:delete für Ihren API key.

i

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

!

Das kann nicht rückgängig gemacht werden. Bereits gesendete Kampagnen und E-Mails behalten ihre eigene Kopie des Inhalts und sind nicht betroffen.

i

Unlayer- und Custom-Templates werden im Dashboard gelöscht.

Argumente

  • template_idstringerforderlich

    Ein html-Template.

    z. B. "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/template',
  {
    commands: [
      {
        command: "delete_template",
        args: {
          template_id: "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"
        }
      }
    ]
  },
  { 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": "delete_template",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 6,
      "data": {
        "template_id": "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
        "deleted": true
      }
    }
  ]
}

Antwortfelder

  • template_id

    Das entfernte Template.

  • deleted

    Immer true.

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 Anzahl Sekunden aus Retry-After ab.

  • CMDMISSING_SCOPE

    Der API key hat nicht den Scope, den dieser Befehl braucht.

  • CMDINVALID_ARGS

    Ein Argument ist ungültig: eine fehlerhafte `template_id`, fehlendes `name` oder `html`, ein Name über 255 Zeichen, ein `version_at`, das nicht RFC 3339 entspricht…

  • CMDTEMPLATE_NOT_FOUND

    Das Template ist nicht in Ihrem Konto.

  • CMDTEMPLATE_READ_ONLY

    Ein Unlayer- oder Custom-Template: Bearbeiten Sie es im Dashboard-Editor. Nur html-Templates lassen sich über die API ändern.

  • CMDRATE_LIMITED

    Ihr Konto hat diesen Befehl in der letzten Minute zu oft aufgerufen. Warten Sie eine Minute.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.