Templates: Versi

Pulihkan versi template

Mengembalikan template html ke versi sebelumnya: html, teks, dan subjek. Pemulihan itu sendiri menjadi versi terbaru, jadi Anda juga bisa membatalkannya.

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

Membutuhkan scope template:update pada API key Anda.

i

Hingga 20 panggilan per menit per akun. Jika lebih, perintah menjawab RATE_LIMITED.

Argumen

  • template_idstringwajib

    Template html.

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

  • version_atstringwajib

    version_at dari List Template Versions, apa adanya.

    mis. "2026-10-21T04:09:12.004Z"

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/template',
  {
    commands: [
      {
        command: "restore_template_version",
        args: {
          template_id: "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
          version_at: "2026-10-21T04:09:12.004Z"
        }
      }
    ]
  },
  { 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);

Respons

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "restore_template_version",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 11,
      "data": {
        "template_id": "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
        "type": "html",
        "name": "Welcome email",
        "reference": "K7Q2M9XR4T",
        "preview": null,
        "has_html": true,
        "html_size": 248,
        "editable": true,
        "created_at": "2026-10-21T04:02:11.310Z",
        "updated_at": "2026-10-21T04:40:02.118Z",
        "subject": "Welcome to Acme",
        "html": "<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>",
        "text": "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"
      }
    }
  ]
}

Field respons

  • template_id

    id template: html_<uuid>, unlayer_<number>, atau custom_<uuid>. Gunakan di semua perintah lain.

  • type

    html (milik Anda, dikirim lewat API), unlayer (dibuat di editor drag-and-drop), atau custom (dibuat di editor Sendcorex).

  • name

    Nama yang Anda berikan.

  • reference

    Kode pendek yang juga mengidentifikasi template di dashboard.

  • preview

    Gambar template, untuk template editor. null untuk template html dan template editor yang belum disimpan.

  • has_html

    false untuk template editor yang sudah dibuat tetapi belum pernah disimpan. Template ini belum bisa dirender atau dikirim.

  • html_size

    Ukuran html, dalam byte.

  • editable

    true untuk template html: Anda bisa memperbarui, memulihkan, dan menghapusnya di sini. Template editor hanya bisa dibaca melalui API.

  • created_at / updated_at

    ISO 8601, UTC.

  • subject

    Subjek default, atau null. Bisa berisi variabel.

  • html

    html-nya. null untuk template editor yang belum pernah disimpan.

  • text

    Versi teks biasa, atau null. Sertakan satu: beberapa klien dan filter lebih menyukai email yang memilikinya.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401INVALID_API_KEY

    API key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.

  • 429RATE_LIMITED

    Lebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.

  • CMDMISSING_SCOPE

    API key tidak memiliki scope yang dibutuhkan perintah ini.

  • CMDINVALID_ARGS

    Ada argumen yang tidak valid: `template_id` yang salah format, `name` atau `html` tidak ada, nama lebih dari 255 karakter, `version_at` yang bukan RFC 3339…

  • CMDTEMPLATE_NOT_FOUND

    Template tidak ada di akun Anda.

  • CMDTEMPLATE_READ_ONLY

    Template Unlayer atau Custom: edit di editor dashboard. Hanya template html yang bisa diubah melalui API.

  • CMDVERSION_NOT_FOUND

    Versi itu tidak ada. Hanya 10 versi terakhir yang disimpan.

  • CMDRATE_LIMITED

    Akun Anda memanggil perintah ini terlalu sering dalam satu menit terakhir. Tunggu satu menit.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.