Templates: Versionen

Vorlagenversionen auflisten

Die gespeicherten Versionen eines Templates, neueste zuerst. Die letzten 10 werden aufbewahrt.

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

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

i

html-Templates speichern bei jedem Erstellen und Aktualisieren eine Version. Editor-Templates speichern eine, wenn Sie im Dashboard auf Speichern klicken (nicht beim automatischen Speichern).

Argumente

  • template_idstringerforderlich

    Das 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: "list_template_versions",
        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": "list_template_versions",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 4,
      "data": {
        "template_id": "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
        "versions": [
          {
            "version_at": "2026-10-21T04:15:40.902Z",
            "html_size": 248,
            "subject": "Welcome to Acme, {{first_name}}"
          },
          {
            "version_at": "2026-10-21T04:09:12.004Z",
            "html_size": 231,
            "subject": "Welcome to Acme"
          },
          {
            "version_at": "2026-10-21T04:02:11.310Z",
            "html_size": 198,
            "subject": null
          }
        ]
      }
    }
  ]
}

Antwortfelder

  • template_id

    Das Template.

  • versions

    Neueste zuerst. Leer, wenn noch nichts gespeichert wurde.

  • versions[].version_at

    Wann die Version gespeichert wurde. Übergeben Sie den Wert unverändert an Restore Template Version.

  • versions[].html_size

    Größe des html dieser Version in Bytes.

  • versions[].subject

    Der Betreff dieser Version oder null.

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.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.