API Reference

Endpoint untuk mengelola Alert Rule dan Alert Type — buat, baca, perbarui, dan hapus konfigurasi aturan notifikasi berbasis event AI Visionaire.

← Kembali ke Alert Rules

Panduan operator: tambah, edit, hapus, dan konfigurasi alert rule.

Otentikasi

API key untuk integrasi, Bearer token untuk sesi pengguna, dan otentikasi WebSocket.

Semua endpoint memerlukan otentikasi. Untuk integrasi, kirim header X-Api-Key: <key> di setiap request tanpa header Authorization. Bearer token (Authorization: Bearer <access_token>, berlaku 30 menit) hanya untuk aplikasi yang menampilkan login Lenz ke penggunanya sendiri dan wajib menyertakan X-Integration-Signature. Basis URL mengikuti variabel lingkungan VITE_API_URL yang dikonfigurasi pada instalasi Lenz. Lihat Otentikasi untuk memilih jalur yang tepat.

Alert Rule

Endpoint utama untuk membuat, membaca, memperbarui, dan menghapus Alert Rule. Setiap rule menghubungkan kondisi trigger berbasis event AI dengan satu atau lebih channel notifikasi.

Daftar Alert Rule

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

page?integer

Nomor halaman, dimulai dari 1

Default1

limit?integer

Jumlah data per halaman

Default10

search?string

Pencarian berdasarkan nama alert rule

filter[active]?string

Filter berdasarkan status aktif: true, false, atau kosong untuk semua

Value in"true" | "false" | ""

instance?string

ID instance pada mode federation (opsional)

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/alert-rules"

{  "ok": true,  "message": "success",  "result": {    "limit": 10,    "current_page": 1,    "total_data": 2,    "total_page": 1,    "offset": 0,    "alert_rules": [      {        "id": 1,        "name": "Deteksi Blacklist Pintu Utama",        "description": "Notifikasi jika wajah blacklist terdeteksi",        "active": true,        "analytic_id": "FR",        "alert_type_id": 1,        "rules": [          {            "attribute": "status",            "operator": "==",            "value": "blacklist",            "streams": [              "stream-uuid-001"            ],            "logic": "AND",            "auto_include_streams": false          }        ],        "notification_channel_ids": [          3,          7        ],        "recipient_rules": null,        "created_at": "2024-06-01T08:00:00Z",        "updated_at": "2024-06-01T09:00:00Z",        "deleted_at": null      }    ]  }}

{  "ok": false,  "message": "unauthorized"}

Buat Alert Rule

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

instance?string

ID instance pada mode federation (opsional)

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Nama deskriptif alert rule

description*string

Deskripsi tujuan rule ini

active*boolean

Status aktif rule saat dibuat

Defaulttrue

analytic_id*string

ID tipe analitik AI yang menjadi sumber event (contoh: FR, LPR, NFV4-CE)

alert_type_id*integer

ID Alert Type yang menentukan level keparahan (CRITICAL, WARNING, atau INFORMATION)

rules*array<>

Array kondisi trigger; minimal satu rule wajib ada

notification_channel_ids?array<integer>

Daftar ID notification channel tujuan pengiriman notifikasi

Default[]

recipient_rules?array<>

Kondisi targeting penerima notifikasi real-time via WebSocket; null berarti semua user menerima

Defaultnull

Response Body

`application/json`

curl -X POST "https://lenz.example.com/api/alert-rules" \  -H "Content-Type: application/json" \  -d '{    "name": "Deteksi Blacklist Pintu Utama",    "description": "Kirim notifikasi jika wajah dengan status blacklist terdeteksi",    "active": true,    "analytic_id": "FR",    "alert_type_id": 1,    "rules": [      {        "attribute": "status",        "operator": "==",        "value": "blacklist",        "streams": [          "stream-uuid-001",          "stream-uuid-002"        ],        "logic": "AND",        "auto_include_streams": false      }    ],    "notification_channel_ids": [      3    ],    "recipient_rules": null  }'

{  "ok": true,  "message": "alert rule created successfully"}

{  "ok": false,  "message": "invalid request body"}

{  "ok": false,  "message": "unauthorized"}

Detail Alert Rule

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik alert rule

Query Parameters

instance?string

ID instance pada mode federation (opsional)

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/alert-rules/0"

{  "ok": true,  "message": "success",  "alert_rule": {    "id": 1,    "name": "Deteksi Blacklist Pintu Utama",    "description": "Notifikasi jika wajah blacklist terdeteksi",    "active": true,    "analytic_id": "FR",    "alert_type_id": 1,    "rules": [      {        "attribute": "status",        "operator": "==",        "value": "blacklist",        "streams": [          "stream-uuid-001"        ],        "logic": "AND",        "auto_include_streams": false      }    ],    "notification_channel_ids": [      3,      7    ],    "recipient_rules": [      {        "attribute": "role_id",        "operator": "==",        "value": "2"      }    ],    "created_at": "2024-06-01T08:00:00Z",    "updated_at": "2024-06-01T09:00:00Z",    "deleted_at": null  }}

{  "ok": false,  "message": "alert rule not found"}

Perbarui Alert Rule

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik alert rule

Query Parameters

instance?string

ID instance pada mode federation (opsional)

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

Nama baru alert rule

description?string

Deskripsi baru

active?boolean

Status aktif atau nonaktif

analytic_id?string

ID analitik baru

alert_type_id?integer

ID Alert Type baru

rules?array<>

Array kondisi trigger yang diperbarui; menggantikan seluruh kondisi sebelumnya

notification_channel_ids?array<integer>

Daftar ID channel yang diperbarui; menggantikan daftar channel sebelumnya

recipient_rules?array<>

Kondisi targeting penerima yang diperbarui; null berarti semua user menerima

Response Body

`application/json`

curl -X PUT "https://lenz.example.com/api/alert-rules/0" \  -H "Content-Type: application/json" \  -d '{    "active": false  }'

{  "ok": true,  "message": "alert rule updated successfully"}

{  "ok": false,  "message": "alert rule not found"}

Hapus Alert Rule

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik alert rule

Query Parameters

instance?string

ID instance pada mode federation (opsional)

Response Body

`application/json`

curl -X DELETE "https://lenz.example.com/api/alert-rules/0"

{  "ok": true,  "message": "alert rule deleted successfully"}

{  "ok": false,  "message": "alert rule not found"}

In: header

Query Parameters

instance?string

ID instance pada mode federation (opsional)

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/alert-type"

{  "ok": true,  "message": "success",  "data": [    {      "id": 1,      "level": "CRITICAL",      "color": "#FF0000",      "duration_ms": 10000,      "sound_data": null,      "sound_updated_at": null,      "instance": "core",      "created_at": "2024-01-01T00:00:00Z",      "updated_at": "2024-01-01T00:00:00Z"    },    {      "id": 2,      "level": "WARNING",      "color": "#FFA500",      "duration_ms": 7000,      "sound_data": null,      "sound_updated_at": null,      "instance": "core",      "created_at": "2024-01-01T00:00:00Z",      "updated_at": "2024-01-01T00:00:00Z"    },    {      "id": 3,      "level": "INFORMATION",      "color": "#0077FF",      "duration_ms": 5000,      "sound_data": null,      "sound_updated_at": null,      "instance": "core",      "created_at": "2024-01-01T00:00:00Z",      "updated_at": "2024-01-01T00:00:00Z"    }  ]}

{  "ok": false,  "message": "unauthorized"}

Detail Alert Type

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik Alert Type

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/alert-type/0"

{  "ok": true,  "message": "success",  "data": {    "id": 1,    "level": "CRITICAL",    "color": "#FF0000",    "duration_ms": 10000,    "sound_data": null,    "sound_updated_at": null,    "instance": "core",    "created_at": "2024-01-01T00:00:00Z",    "updated_at": "2024-01-01T00:00:00Z"  }}

{  "ok": false,  "message": "alert type not found"}

Perbarui Alert Type

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik Alert Type

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

level?string

Tingkat keparahan baru

Value in"CRITICAL" | "WARNING" | "INFORMATION"

color?string

Warna hex baru untuk representasi visual

duration_ms?integer

Durasi tampil notifikasi dalam milidetik

sound_data?string

Audio notifikasi baru dalam format base64 MP3 (opsional)

Response Body

`application/json`

curl -X PUT "https://lenz.example.com/api/alert-type/0" \  -H "Content-Type: application/json" \  -d '{    "color": "#FF8C00",    "duration_ms": 8000  }'

{  "ok": true,  "message": "alert type updated successfully",  "data": {    "id": 2,    "level": "WARNING",    "color": "#FF8C00",    "duration_ms": 8000,    "sound_data": null,    "sound_updated_at": null,    "instance": "core",    "created_at": "2024-01-01T00:00:00Z",    "updated_at": "2024-06-01T12:00:00Z"  }}

API Reference — Alert

← Kembali ke Alert Rules

Otentikasi

200application/json

401application/json

200application/json

400application/json

401application/json

200application/json

404application/json

200application/json

404application/json

200application/json

404application/json

200application/json

401application/json

200application/json

404application/json

200application/json

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`