Langsung ke konten utama
POST
/
scheduled
Jadwalkan Skrip Baru
curl --request POST \
  --url https://api.altostrat.io/scheduled \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "test_site_id": "site_2Al5z3gXyY5f6Z7h8j9k0l1m",
  "make_backup": true,
  "abort_if_offline": true,
  "description": "Pemeliharaan peer BGP malam hari",
  "script": "/routing bgp peer disable [find name=peer1]",
  "launch_at": "2025-12-01T04:00:00Z",
  "sites": [
    "site_1AbCdEfGhIjKlMnOpQrStUv",
    "site_2BcDeFgHiJkLmNoPqRsTuVw"
  ],
  "notify": [
    "auth0|5f9d4b3c2e1a0b006f8b4c5d"
  ]
}'
{
  "id": "018f5bda-4690-4432-8472-358b2734f19b",
  "created_by": "auth0|642b7f3b8b3b3e3e3e3e3e3e",
  "test_site_id": "site_2Al5z3gXyY5f6Z7h8j9k0l1m",
  "make_backup": true,
  "abort_if_offline": false,
  "description": "Pembaruan aturan firewall mingguan",
  "summary": "Skrip ini menambahkan aturan filter firewall untuk memblokir input dari daftar alamat spesifik bernama \"blacklist\".",
  "script": "/ip firewall filter add action=drop chain=input src-address-list=blacklist",
  "status": "scheduled",
  "authorized_at": "2025-10-30T10:00:00.000000Z",
  "cancelled_at": null,
  "launch_at": "2025-11-01T02:00:00.000000Z",
  "t_minus": "dalam 2 hari",
  "started_at": "2025-11-01T02:00:05.000000Z",
  "sites": [
    "site_1AbCdEfGhIjKlMnOpQrStUv"
  ],
  "notify": [
    "auth0|5f9d4b3c2e1a0b006f8b4c5d"
  ],
  "progress": {
    "completed": [
      "site_1AbCdEfGhIjKlMnOpQrStUv"
    ],
    "failed": [
      "site_2BcDeFgHiJkLmNoPqRsTuVw"
    ],
    "pending": [
      "site_3CdEfGhIjKlMnOpQrStUvWx"
    ]
  },
  "created_at": "2025-10-29T12:44:27.000000Z",
  "updated_at": "2025-10-29T13:05:00.000000Z"
}

Authorizations

​
Authorization
string
header
required

API Altostrat SDX menggunakan token JWT Bearer untuk autentikasi. Dapatkan token melalui API Autentikasi dan sertakan dalam header Otorisasi sebagai 'Bearer {token}'.

Body

application/json
​
make_backup
boolean
required

Jika benar, buat cadangan konfigurasi sebelum mengeksekusi skrip.

Example:

true

​
abort_if_offline
boolean
required

Jika benar, jangan mencoba menjalankan skrip di situs yang sedang offline.

Example:

true

​
description
string
required

Nama yang dapat dibaca manusia untuk skrip terjadwal.

Example:

"Pemeliharaan peer BGP malam hari"

​
script
string
required

Konten lengkap skrip MikroTik RouterOS.

Example:

"/routing bgp peer disable [find name=peer1]"

​
launch_at
string<date-time>
required

Tanggal dan waktu UTC yang dijadwalkan untuk eksekusi. Harus di masa depan.

Example:

"2025-12-01T04:00:00Z"

​
sites
string<uuid>[]
required

Array ID situs yang menjadi target.

Example:
[
  "site_1AbCdEfGhIjKlMnOpQrStUv",
  "site_2BcDeFgHiJkLmNoPqRsTuVw"
]
​
notify
string<uuid>[]
required

Array ID pengguna untuk menerima notifikasi.

Example:
["auth0|5f9d4b3c2e1a0b006f8b4c5d"]
​
test_site_id
string<uuid> | null

Pengidentifikasi unik dari situs yang ditunjuk untuk uji coba.

Example:

"site_2Al5z3gXyY5f6Z7h8j9k0l1m"

Response

Skrip terjadwal berhasil dibuat.

​
id
string<uuid>

Pengidentifikasi unik untuk skrip terjadwal.

Example:

"018f5bda-4690-4432-8472-358b2734f19b"

​
created_by
string<uuid>

ID pengguna dari orang yang membuat jadwal skrip.

Example:

"auth0|642b7f3b8b3b3e3e3e3e3e3e"

​
test_site_id
string<uuid> | null

Pengidentifikasi unik dari situs yang ditunjuk untuk uji coba.

Example:

"site_2Al5z3gXyY5f6Z7h8j9k0l1m"

​
make_backup
boolean

Jika benar, cadangan konfigurasi akan dibuat pada setiap perangkat target sebelum skrip dieksekusi.

Example:

true

​
abort_if_offline
boolean

Jika benar, eksekusi skrip akan dibatalkan untuk sebuah situs jika situs tersebut offline pada saat peluncuran.

Example:

false

​
description
string

Nama atau deskripsi yang dapat dibaca manusia untuk jadwal skrip.

Example:

"Pembaruan aturan firewall mingguan"

​
summary
string | null

Ringkasan tujuan skrip yang dihasilkan oleh AI.

Example:

"Skrip ini menambahkan aturan filter firewall untuk memblokir input dari daftar alamat spesifik bernama \"blacklist\"."

​
script
string

Konten lengkap skrip MikroTik RouterOS yang akan dieksekusi.

Example:

"/ip firewall filter add action=drop chain=input src-address-list=blacklist"

​
status
enum<string>

Status saat ini dari skrip terjadwal.

Opsi yang tersedia:
unauthorized,
scheduled,
launched,
cancelled
Example:

"scheduled"

​
authorized_at
string<date-time> | null

Stempel waktu saat eksekusi skrip diotorisasi. Null jika belum diotorisasi.

Example:

"2025-10-30T10:00:00.000000Z"

​
cancelled_at
string<date-time> | null

Stempel waktu saat skrip dibatalkan.

Example:

null

​
launch_at
string<date-time>

Tanggal dan waktu UTC yang dijadwalkan untuk eksekusi skrip.

Example:

"2025-11-01T02:00:00.000000Z"

​
t_minus
string | null

Hitung mundur yang dapat dibaca manusia menuju waktu peluncuran.

Example:

"dalam 2 hari"

​
started_at
string<date-time> | null

Stempel waktu saat eksekusi skrip benar-benar dimulai.

Example:

"2025-11-01T02:00:05.000000Z"

​
sites
string<uuid>[]

Daftar ID situs di mana skrip akan dieksekusi.

​
notify
string<uuid>[]

Daftar ID pengguna untuk diberitahu tentang kemajuan skrip dan permintaan otorisasi.

​
progress
object

Mewakili kemajuan eksekusi skrip yang diluncurkan di seluruh situs targetnya.

​
created_at
string<date-time>

Stempel waktu saat skrip terjadwal dibuat.

Example:

"2025-10-29T12:44:27.000000Z"

​
updated_at
string<date-time>

Stempel waktu saat skrip terjadwal terakhir diperbarui.

Example:

"2025-10-29T13:05:00.000000Z"