Langsung ke konten utama
POST
/
scans
/
cve
/
scheduled
Buat Jadwal Pemindaian
curl --request POST \
  --url https://api.altostrat.io/scans/cve/scheduled \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Pemindaian Mingguan untuk Kantor Pusat",
  "day_of_week": 1,
  "time_of_day": "02:00",
  "every_n_weeks": 2,
  "timezone": "America/New_York",
  "min_cvss": 4,
  "warning_threshold": 7,
  "ignore_offline_sites\"": false,
  "notification_group\"": "security-alerts",
  "sites": [
    {
      "id": "9c3c1392-7f36-4240-85f2-273573c0384a",
      "subnet": "192.168.1.0/24"
    }
  ]
}'
{
  "id": "9c43cc95-f313-49a3-b632-524f7a24503b",
  "description": "Pemindaian Mingguan untuk Kantor Pusat",
  "day_of_week": 1,
  "time_of_day": "02:00",
  "every_n_weeks": 2,
  "timezone": "America/New_York",
  "min_cvss": 4,
  "warning_threshold": 7,
  "ignore_offline_sites": false,
  "next_scan_at": "2025-11-10T02:00:00-05:00",
  "running": false,
  "sites": [
    {
      "id": "9c3c1392-7f36-4240-85f2-273573c0384a",
      "subnet": "192.168.1.0/24"
    }
  ],
  "created_at": "2025-10-28T14:30:00Z",
  "updated_at": "2025-10-29T09:00:00Z",
  "status": "ready",
  "last_run_at": "2025-10-27T02:00:00-05:00",
  "notification_group": "security-alerts"
}

Authorizations

โ€‹
Authorization
string
header
required

Masukkan token bearer Anda dalam format: Bearer {token}

Body

application/json

Konfigurasi untuk jadwal pemindaian baru.

โ€‹
description
string
required

Nama yang dapat dibaca manusia untuk jadwal pemindaian.

Example:

"Pemindaian Mingguan untuk Kantor Pusat"

โ€‹
day_of_week
integer
required

Hari dalam seminggu untuk menjalankan pemindaian (0=Minggu, 1=Senin, ..., 6=Sabtu).

Example:

1

โ€‹
time_of_day
string<time>
required

Waktu untuk menjalankan pemindaian dalam format 24 jam (JJ:mm).

Example:

"02:00"

โ€‹
every_n_weeks
integer
required

Frekuensi pemindaian dalam minggu (misalnya, 2 untuk setiap 2 minggu). Minimum 2.

Example:

2

โ€‹
timezone
string
required

Nama basis data zona waktu IANA (misalnya, 'America/New_York', 'UTC').

Example:

"America/New_York"

โ€‹
min_cvss
number
required

Skor CVSS minimum agar kerentanan disertakan dalam laporan. Harus kurang dari warning_threshold.

Example:

4

โ€‹
warning_threshold
number
required

Skor CVSS di mana kerentanan dianggap sebagai peringatan prioritas tinggi. Harus lebih besar dari min_cvss.

Example:

7

โ€‹
sites
object[]
required

Daftar situs dan subnetnya yang akan dipindai.

โ€‹
notification_group
string
required

Pengenal untuk grup notifikasi yang akan menerima peringatan pemindaian.

Example:

"security-alerts"

โ€‹
ignore_offline_sites
boolean

Jika true, pemindaian tidak akan gagal jika situs sedang offline. Default-nya false.

Example:

false

Response

Jadwal pemindaian berhasil dibuat.

โ€‹
id
string<uuid>

Pengenal unik untuk jadwal pemindaian.

Example:

"9c43cc95-f313-49a3-b632-524f7a24503b"

โ€‹
description
string

Nama yang dapat dibaca manusia untuk jadwal pemindaian.

Example:

"Pemindaian Mingguan untuk Kantor Pusat"

โ€‹
day_of_week
integer

Hari dalam seminggu untuk menjalankan pemindaian (0=Minggu, 1=Senin, ..., 6=Sabtu).

Example:

1

โ€‹
time_of_day
string

Waktu untuk menjalankan pemindaian dalam format 24 jam (JJ:mm).

Example:

"02:00"

โ€‹
every_n_weeks
integer

Frekuensi pemindaian dalam minggu (misalnya, 2 untuk setiap 2 minggu).

Example:

2

โ€‹
timezone
string

Zona waktu di mana time_of_day ditentukan.

Example:

"America/New_York"

โ€‹
min_cvss
number

Skor CVSS minimum agar kerentanan disertakan dalam laporan.

Example:

4

โ€‹
warning_threshold
number

Skor CVSS di mana kerentanan dianggap sebagai peringatan prioritas tinggi.

Example:

7

โ€‹
ignore_offline_sites
boolean

Jika true, pemindaian tidak akan gagal jika situs sedang offline.

Example:

false

โ€‹
next_scan_at
string<date-time>

Stempel waktu yang dihitung untuk pemindaian terjadwal berikutnya.

Example:

"2025-11-10T02:00:00-05:00"

โ€‹
running
boolean

Menunjukkan apakah pemindaian untuk jadwal ini sedang berlangsung.

Example:

false

โ€‹
sites
object[]

Daftar situs dan subnetnya yang akan dipindai.

โ€‹
created_at
string<date-time>

Stempel waktu saat jadwal dibuat.

Example:

"2025-10-28T14:30:00Z"

โ€‹
updated_at
string<date-time>

Stempel waktu saat jadwal terakhir diperbarui.

Example:

"2025-10-29T09:00:00Z"

โ€‹
status
string

Status saat ini dari siklus hidup jadwal pemindaian.

Example:

"ready"

โ€‹
last_run_at
string<date-time>

Stempel waktu saat pemindaian untuk jadwal ini terakhir dimulai.

Example:

"2025-10-27T02:00:00-05:00"

โ€‹
notification_group
string

Pengenal untuk grup notifikasi yang akan menerima peringatan pemindaian.

Example:

"security-alerts"