Kecemasan

Platform Teras
duress_acknowledge_incidentKecemasan

Mengakui insiden duress yang terbuka bagi pihak pengguna: ia merekodkan bahawa mereka sedang bertindak balas dan boleh menghentikan peningkatan selanjutnya. Hanya insiden terbuka boleh diakui.

Sentiasa sahkan dahulu. Panggil tanpa confirm untuk mendapatkan insiden, beritahu pengguna perkara yang mereka akui, dan panggil semula dengan confirm: true hanya selepas mereka bersetuju.

Dalam aliran kerja, atau daripada Ejen, ini hanya berfungsi jika pelan tindak balas kemudahan membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera. Untuk menutup insiden, gunakan duress_resolve_incident.

Parameter

NamaJenisPenerangan
incidentId*stringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress.
notestringNota pilihan, cth. "Dalam perjalanan ke kaunter penyambut tetamu"
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_buttons_readKecemasanDuress ConfigurationPengurusan Peranti

Membaca butang duress di sesebuah kemudahan: statusnya (bateri, terakhir didengar, terakhir diuji), profil penuh (label, bilik, zon, penempatan, kamera, pintu dan skrin yang dipautkan, amaran yang dibisukan, kesihatan penyeliaan), perkara yang boleh dipautkan kepadanya, skrin yang menyampaikan tekanannya, dan ujian persediaan butang yang baru ditambah.

Bateri: low ialah 30% atau kurang (ganti tidak lama lagi), critical 20% atau kurang (ganti sekarang). Bateri dan lastSeenAt bernilai null bermakna belum ada skrin yang mendengar butang itu. Masa dalam format ISO.

Tindakan:

  • status: Status butang. Setiap butang dengan zon, bilik, bateri, bila skrin terakhir mendengarnya dan bila ia terakhir diuji. "Adakah butang duress berfungsi?", "Butang mana yang memerlukan bateri baharu?"
  • list: Profil butang. Profil penuh setiap butang: perkara yang diubah oleh duress_buttons_write update, serta isyarat, skrin yang mendengarnya dalam sehari yang lalu, kesihatan penyeliaan dan ujian persediaan yang sedang menunggu.
  • link_options: Pilihan pautan. Kamera, pintu, skrin dan zon akses kemudahan yang boleh dipautkan kepada butang (id untuk duress_buttons_write update).
  • receivers: Penerima butang. Skrin paparan di kemudahan yang mendengar butang dan menyampaikan tekanan, serta sama ada setiap satu dalam talian. ready bernilai false apabila tiada apa-apa yang dapat mendengar butang.
  • setup_test: Ujian persediaan. Ujian persediaan butang yang baru ditambah: waiting (tekanan pertamanya hanya ujian), received, expired, ended atau none, dan sama ada skrin telah mendengarnya sejak ia ditambah. Memerlukan deviceSerialNumber.

Parameter

NamaJenisPenerangan
action*"status" | "list" | "link_options" | "receivers" | "setup_test"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan.
limitintegerItem setiap halaman (lalai 25, maksimum 100) (status, list)
cursorstringnextCursor daripada halaman sebelumnya (status, list)
deviceSerialNumberstringNombor siri butang, daripada duress_buttons_read status atau list (setup_test)
duress_buttons_writeDuress ConfigurationKecemasanPengurusan Peranti

Mengubah butang duress di sesebuah kemudahan: menambah butang baharu, profilnya (label, bilik, zon, penempatan, nota, kamera, pintu, skrin dan zon akses yang dipautkan, amaran peranti yang dibisukan), membuat butang berbunyi supaya kakitangan dapat mencarinya, menamatkan ujian persediaan butang baharu supaya ia aktif, dan mengalih keluar butang.

Medan yang ditinggalkan daripada update mengekalkan nilainya; null mengosongkannya. Baca profil semasa dengan duress_buttons_read list.

Tindakan:

  • update: Kemas kini butang. Menyimpan profil butang di kemudahan tempat ia didaftarkan (memerlukan Duress Configuration di sana). zone ialah 001 hingga 999 dan unik di kemudahan itu. alertsMutedUntil (ISO, maksimum 30 hari ke hadapan) membisukan amaran bateri dan luar taliannya. Memerlukan deviceSerialNumber.
  • locate: Buat butang berbunyi. Membuat butang berbunyi dan berkelip selama 30 saat supaya kakitangan dapat mencarinya, cth. butang yang terus melaporkan bateri lemah. Skrin berhampiran menghantar arahan itu, jadi butang mesti berada dalam julat salah satu skrin. Tidak boleh semasa ia mempunyai penggera terbuka. Memerlukan deviceSerialNumber.
  • go_live: Aktifkan butang baharu. Menamatkan ujian persediaan butang yang baru ditambah serta-merta, supaya tekanan seterusnya ialah penggera sebenar. Semak duress_buttons_read setup_test terlebih dahulu. Memerlukan Pengurusan Peranti atau Duress Configuration di kemudahan itu. Memerlukan deviceSerialNumber. Meminta pengesahan.
  • remove: Alih keluar butang. Menyahpasangkan butang daripada kemudahan dan memadamkan profilnya, yang membebaskan zonnya. Tidak boleh semasa ia mempunyai penggera terbuka. Memerlukan Pengurusan Peranti di kemudahan itu. Memerlukan deviceSerialNumber. Meminta pengesahan.
  • add: Tambah butang. Mendaftarkan butang duress baharu di kemudahan menggunakan nombor siri yang dicetak padanya. Secara lalai, tekanan pertamanya dalam 30 minit seterusnya hanyalah ujian (setupTest). Kemudahan memerlukan skrin dengan Duress alarm monitoring dihidupkan atau IoT Gateway. Memerlukan Pengurusan Peranti di kemudahan itu. Memerlukan deviceSerialNumber. Meminta pengesahan.

Parameter

NamaJenisPenerangan
action*"update" | "locate" | "go_live" | "remove" | "add"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan.
deviceSerialNumberstringNombor siri butang, daripada duress_buttons_read status atau list
labelstringnullNama yang digunakan kakitangan untuk butang itu, cth. "Kaunter hadapan" (update)
roomstringnullBilik tempat butang itu berada (update, add)
zonestringnullZon pusat pemantauan, 001 hingga 999 (update)
placement"fixed" | "carried" | "null"fixed (dipasang tetap) atau carried (loket) (update)
notesstringnullNota untuk kakitangan (update)
cameraIdsarraynullKamera yang dipautkan kepada butang (id daripada duress_buttons_read link_options); null atau [] mengosongkannya (update)
doorIdsarraynullPintu yang dipautkan kepada butang (id daripada duress_buttons_read link_options); null atau [] mengosongkannya (update)
screenIdsarraynullSkrin yang dipautkan kepada butang (id daripada duress_buttons_read link_options); null atau [] mengosongkannya (update)
accessZoneIdstringnullZon akses tempat butang itu berada (update)
alertsMutedUntilstringnullTarikh-masa ISO sehingga amaran perantinya dibisukan; null menyahbisukan (update)
muteReasonstringnullSebab amarannya dibisukan (update)
setupTestbooleanLalai true: tekanan pertama hanyalah ujian (add)
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_end_testKecemasan

Menamatkan ujian duress yang sedang berjalan di sesebuah kemudahan serta-merta, supaya tekanan seterusnya ialah penggera sebenar. Keputusan menyusul kira-kira 10 minit kemudian, seperti mana-mana ujian lain.

Parameter

NamaJenisPenerangan
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan.
duress_incidents_readKecemasan

Membaca insiden penggera duress (kakitangan menekan butang duress, atau aliran kerja mencetuskannya): senarai, garis masa dan penghantaran satu insiden, laporan postmortem, dan rakaman CCTV sekitar penggera.

Status: open (belum ada sesiapa yang mengakuinya), acknowledged (seseorang sedang bertindak balas), resolved (ditutup, dengan disposisi: genuine, false_alarm, test atau unknown). active bermaksud open atau acknowledged. Insiden ujian (isTest) datang daripada ujian butang; testType 'unplanned' ialah penggera yang dicetuskan sebagai sebenar tetapi diselesaikan oleh responden sebagai ujian.

Status penghantaran: sent, acknowledged (penerima mengesahkan), failed (lihat error), shadow (larian percubaan, tiada apa-apa dihantar). Penghantaran ke pusat pemantauan turut dijumlahkan di bawah monitoringCentre. Keputusan menamakan orang tetapi tidak pernah menyertakan nombor telefon atau alamat e-mel. Masa dalam format ISO.

Tindakan:

  • list: Senaraikan insiden. Terbaharu dahulu. scope: facility (lalai; kemudahan yang diberikan atau disambungkan) atau organisation (setiap kemudahan di dalamnya yang boleh Anda lihat; lalai kepada organisasi kemudahan tersebut).
  • get: Dapatkan insiden. Status, butang yang ditekan, garis masa (tekanan, peningkatan, pengakuan, nota) dan setiap percubaan penghantaran pemberitahuan atau ke pusat pemantauan bersama hasilnya. Memerlukan incidentId.
  • report: Laporan insiden. Untuk postmortem: insiden, saat untuk mengakui dan menyelesaikan, langkah yang dicapai, setiap entri garis masa, perkara yang dihantar bagi setiap saluran dan yang gagal, serta sama ada rakaman disimpan. Gandingkan dengan duress_incidents_write add_note untuk meletakkan postmortem pada insiden. Memerlukan incidentId.
  • footage_previews: Rakaman penggera. Setiap kamera dalam rakaman penggera: statusnya, bilangan bingkai dan klip, klip yang dimuat naik, dan bingkai yang paling hampir dengan tekanan (posterSeconds). Dengan cameraId, kamera itu sahaja serta saat Unix setiap bingkai (frameSeconds). Memerlukan CCTV di kemudahan tersebut. Memerlukan incidentId.
  • footage_frame: Bingkai rakaman penggera. Satu bingkai timelapse daripada rakaman penggera, dikembalikan sebagai imej: salinan yang disimpan setelah rakaman disimpan, jika tidak bingkai langsung dalam tetingkap penggera. seconds ialah nilai posterSeconds atau frameSeconds daripada footage_previews. Memerlukan incidentId, cameraId, seconds.

Parameter

NamaJenisPenerangan
action*"list" | "get" | "report" | "footage_previews" | "footage_frame"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
scope"facility" | "organisation"Lalai facility (list)
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. (list)
organisationIdstringUntuk scope organisation. Lalai kepada organisasi kemudahan tersebut. (list)
status"active" | "open" | "acknowledged" | "resolved"active ialah open atau acknowledged (list)
fromstringTarikh-masa ISO: insiden yang dibuka pada atau selepas masa ini (list)
tostringTarikh-masa ISO: insiden yang dibuka pada atau sebelum masa ini (list)
limitintegerItem setiap halaman (lalai 25, maksimum 100) (list)
cursorstringnextCursor daripada halaman sebelumnya (list)
incidentIdstringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. (get, report, footage_previews, footage_frame)
cameraIdstringKamera dalam rakaman penggera, daripada footage_previews (footage_previews, footage_frame)
secondsintegerstringMasa bingkai sebagai saat Unix 10 digit (footage_frame)
duress_incidents_writeKecemasanDuress Configuration

Mengubah insiden duress tanpa menyentuh penggera itu sendiri: menamakannya, menambah nota kakitangan, dan menyimpan atau melepaskan rakaman CCTV sekitarnya. Tiada sesiapa yang dimaklumkan. Untuk mengakui, menyelesaikan atau memaklumkan responden, gunakan duress_acknowledge_incident, duress_resolve_incident atau duress_post_update.

Tindakan:

  • rename: Namakan insiden. Menamakan insiden supaya mudah dicari kemudian, cth. "Pelawat agresif di kaunter hadapan". Nama kosong atau null mengalih keluarnya. Nama dipaparkan dalam konsol Duress dan laporan. Memerlukan incidentId.
  • add_note: Tambah nota. Menambah nota pada garis masa insiden, cth. perkara yang ditemui pengguna atau siapa yang hadir. Sebarang status; hanya kakitangan yang melihat nota dan nota tidak mengubah insiden. Tulis menggunakan perkataan pengguna dan sahkan susunan katanya dengan mereka terlebih dahulu. Memerlukan incidentId, note.
  • keep_footage: Simpan rakaman penggera. Menyimpan rakaman CCTV sekitar penggera sebenar yang telah diselesaikan supaya tidak dipadamkan bersama rakaman biasa, menggunakan minit dan kamera pelan tindak balas. Berlaku beberapa minit kemudian, setelah dimuat naik. Bukan untuk ujian, penggera terbuka, atau rakaman yang sudah disimpan atau dilepaskan. Memerlukan incidentId.
  • release_footage: Lepaskan rakaman yang disimpan. Melepaskan rakaman yang disimpan untuk sesuatu penggera: klip kembali kepada pengekalan biasa dan bingkai yang disimpan dipadamkan, jadi rakaman tidak lagi boleh dilihat setelah rakaman biasa tamat tempoh. Memerlukan Duress Configuration di kemudahan tersebut. Memerlukan incidentId. Meminta pengesahan.

Parameter

NamaJenisPenerangan
action*"rename" | "add_note" | "keep_footage" | "release_footage"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
incidentIdstringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress.
namestringnullNama; kosong atau null mengalih keluarnya (rename)
notestringNota (add_note)
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_lift_lockdownKecemasan

Menarik balik sekatan (lockdown) penggera duress: pintu yang dikuncinya membenarkan orang masuk semula. Berfungsi tanpa mengira status penggera.

Sahkan dahulu. Panggil tanpa confirm untuk melihat sekatan, beritahu pengguna, dan panggil semula dengan confirm: true setelah mereka bersetuju.

Parameter

NamaJenisPenerangan
incidentId*stringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress.
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_post_updateKecemasan

Menyiarkan kemas kini kepada orang yang bertindak balas terhadap penggera duress, cth. "Polis sedang dalam perjalanan" atau "Keadaan selamat, orang tersebut telah beredar". Kemas kini dipaparkan pada halaman penggera mereka dan dalam aplikasi Duress, dan bagi penggera sebenar, pelan tindak balas juga boleh menghantarnya melalui SMS kepada semua orang yang telah menerima SMS tentang penggera itu. Kemas kini boleh disiarkan sehingga 24 jam selepas penggera diselesaikan.

Sahkan dahulu. Panggil tanpa confirm untuk menyemak insiden, tunjukkan susunan kata yang tepat kepada pengguna, dan panggil semula dengan confirm: true setelah mereka bersetuju. Untuk perkara yang hanya patut dilihat oleh kakitangan, gunakan duress_incidents_write add_note.

Parameter

NamaJenisPenerangan
incidentId*stringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress.
text*stringKemas kini, kata demi kata
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_raise_alarmKecemasan

Mencetuskan penggera duress sebenar di kemudahan, seolah-olah butang ditekan: pelan tindak balas dijalankan (orang dimaklumkan, peningkatan dan peringatan menyusul, tindakan tindak balas dijalankan) dan penggera menyatakan bahawa ia dicetuskan oleh aliran kerja ini, bersama sebabnya.

  • reason: perkara yang berlaku, cth. "Pintu dibuka secara paksa di pintu keluar belakang" (sehingga 200 aksara).
  • deviceSerialNumber: pilihan. Butang yang lokasinya hendak digunakan; hanya dalam kes ini pusat pemantauan turut dimaklumkan, dengan zon butang tersebut.

Hanya sebagai langkah aliran kerja, di kemudahan yang pelan tindak balasnya membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera. Selagi penggera aliran kerja ini terbuka, ia tidak akan mencetuskan penggera lain; sebaliknya ia mengembalikan penggera tersebut.

Parameter

NamaJenisPenerangan
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan.
reason*stringPerkara yang berlaku
deviceSerialNumberstringButang di kemudahan (pilihan)
duress_reports_readKecemasanDuress Configuration

Laporan pematuhan Duress bagi kemudahan, jenama atau organisasi: masa tindak balas (P50/P95), insiden mengikut disposisi dan kadar penggera palsu, liputan ujian dan kemudahan yang tertunggak, masa operasi butang, kejayaan penghantaran ke pusat pemantauan, dan eksport insiden demi insiden. Serta amaran penggera terkini yang tidak dihantar di satu kemudahan.

Hari mengikut waktu tempatan kemudahan; tempoh melebihi 400 hari dipendekkan (range.capped). Insiden sebenar dan ujian dikira secara berasingan. Tempoh dalam ms (p50Ms, p95Ms). Laporan jenama hanya meliputi kemudahan yang boleh Anda akses melainkan Anda mempunyai akses seluruh organisasi (scope.restrictedToAccessibleFacilities).

Tindakan:

  • overview: Gambaran keseluruhan laporan Duress. Jumlah, trend bulanan dan metrik bagi setiap organisasi, jenama dan kemudahan (incidents, testCoverage, deviceUptime, deliveries). Kemudahan dipaparkan berhalaman.
  • compliance_summary: Ringkasan pematuhan Duress. Perkara yang dipaparkan dalam PDF pematuhan: liputan ujian dengan kemudahan yang tertunggak, masa operasi butang, kejayaan penghantaran, ujian terkini (testHistory), dan bagi setiap kemudahan, ujian, latih tubi dan penggera sebenar terakhirnya bersama masa operasi setiap butang. Kemudahan dipaparkan berhalaman.
  • incident_export: Eksport insiden Duress. Satu baris bagi setiap insiden, terlama dahulu, dengan lajur eksport CSV: kemudahan, ujian atau sebenar, status, disposisi, waktu tempatan, saat untuk mengakui dan menyelesaikan, siapa yang mengakui dan menyelesaikan, butang dan bilangan penghantaran.
  • delivery_problems: Amaran penggera yang tidak dihantar. Penggera atau ujian terkini kemudahan (dengan keseluruhan tetingkap ujiannya) dan amaran yang tidak pernah sampai, mengikut saluran. problems bernilai null apabila semuanya berjaya dihantar. Memerlukan Duress atau Duress Configuration di sana.

Parameter

NamaJenisPenerangan
action*"overview" | "compliance_summary" | "incident_export" | "delivery_problems"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
scope"facility" | "brand" | "organisation"Lalai: id paling khusus yang diberikan, jika tidak kemudahan yang disambungkan. (overview, compliance_summary, incident_export)
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan.
brandIdstringID jenama, untuk templat jenama dan bukannya kemudahan (overview, compliance_summary, incident_export)
organisationIdstringMemerlukan akses Duress seluruh organisasi (overview, compliance_summary, incident_export)
fromstringHari pertama, YYYY-MM-DD waktu tempatan kemudahan (lalai 30 hari sebelum to) (overview, compliance_summary, incident_export)
tostringHari terakhir, YYYY-MM-DD waktu tempatan kemudahan, termasuk (lalai hari ini) (overview, compliance_summary, incident_export)
limitintegerItem setiap halaman (lalai 25, maksimum 100) (overview, compliance_summary, incident_export)
cursorstringnextCursor daripada halaman sebelumnya (overview, compliance_summary, incident_export)
duress_resolve_incidentKecemasan

Menyelesaikan insiden duress: menutup penggera, menghentikan peningkatan dan merekodkan hasilnya. Insiden yang terbuka dan telah diakui boleh diselesaikan.

  • disposition: genuine (kecemasan sebenar), false_alarm, test atau unknown.
  • note: perkara yang berlaku. Wajib bagi penggera sebenar.

Sentiasa sahkan dahulu. Panggil tanpa confirm untuk mendapatkan insiden, beritahu pengguna penggera mana yang mereka tutup dan hasilnya, dan panggil semula dengan confirm: true hanya selepas mereka bersetuju.

Dalam aliran kerja, atau daripada Ejen, ini hanya berfungsi jika pelan tindak balas kemudahan membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera.

Parameter

NamaJenisPenerangan
incidentId*stringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress.
disposition*"genuine" | "false_alarm" | "test" | "unknown"Hasil
notestringPerkara yang berlaku. Wajib apabila disposisi ialah genuine.
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_settings_readKecemasanDuress Configuration

Membaca tetapan Duress: pelan tindak balas (siapa yang dimaklumkan, dalam urutan apa dan bagaimana, di kemudahan atau sebagai templat jenama), pelan diselesaikan yang sebenarnya digunakan oleh enjin penggera, orang dan peranan yang boleh ditambah, amaran peranti (masalah bateri, luar talian, liputan dan penghantaran), peraturan kenalan jenama dan status pelan, gambaran keseluruhan butang jenama atau organisasi, dan destinasi penggera ke pusat pemantauan.

Kemudahan mengikut templat jenamanya (jika tidak, templat organisasinya), melanjutkannya dengan kenalan tambahan (mode extend), atau menggantikannya dengan pelannya sendiri (mode replace). Ubah tetapan dengan duress_settings_write. Masa dalam format ISO.

Tindakan:

  • response_plan: Pelan tindak balas. Pelan yang berkuat kuasa di kemudahan (effective) dan kandungan setiap peringkat (sources: facility, brand, organisation), atau dengan brandId sahaja, templat jenama. Kenalan adalah seperti yang disimpan, sedia untuk diedit dan disimpan semula.
  • resolved_plan: Pelan diselesaikan. Siapa yang dihubungi oleh enjin penggera di kemudahan, peringkat demi peringkat: peranan dikembangkan kepada orang, saluran yang boleh digunakan untuk menghubungi setiap orang, kelewatan, dan amaran yang perlu dibaiki sebelum penggera. Nama sahaja, tiada nombor telefon atau e-mel.
  • contact_options: Pilihan kenalan. Orang dan peranan yang boleh ditambah kepada pelan kemudahan (memerlukan Duress Configuration di sana), atau dengan brandId sahaja, kepada templat jenama, selepas peraturan kenalan jenama.
  • device_alerts: Amaran peranti. Siapa yang dimaklumkan tentang bateri lemah, butang luar talian, liputan yang hilang dan penghantaran yang gagal: peraturan di setiap peringkat dan penerima diselesaikan kemudahan, atau dengan brandId sahaja, peraturan jenama.
  • contact_rules: Peraturan kenalan jenama. Peranan yang boleh ditambah kepada pelan oleh kemudahan dalam jenama: allowAllExcept menyembunyikan peranan yang disenaraikan, manual hanya menawarkan peranan tersebut. Memerlukan keperluan yang sama seperti mengedit pelan jenama. Memerlukan brandId.
  • plan_status: Status pelan jenama. Setiap kemudahan dalam jenama: sama ada ia mengikut templat, melanjutkannya atau mempunyai pelannya sendiri, bilangan kenalan yang ditambahnya, dan amaran pelannya. Memerlukan brandId.
  • buttons_summary: Gambaran keseluruhan butang. Setiap kemudahan dalam jenama atau organisasi: butang, bilangan bateri dan luar talian, ujian seterusnya dan terakhir. Data gambaran keseluruhan Brands & Customisation dan organisasi.
  • monitoring: Penghalaan pusat pemantauan. Cara penggera keluar dari kemudahan: eaAlarmType none, cid (panggilan pusat pemantauan melalui eaAlarmProvider) atau relay (panel berwayar melalui eaRelayModel), dan pembekal yang boleh digunakannya.

Parameter

NamaJenisPenerangan
action*"response_plan" | "resolved_plan" | "contact_options" | "device_alerts" | "contact_rules" | "plan_status" | "buttons_summary" | "monitoring"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. (response_plan, resolved_plan, contact_options, device_alerts, monitoring)
brandIdstringID jenama, untuk templat jenama dan bukannya kemudahan (response_plan, contact_options, device_alerts, contact_rules, plan_status, buttons_summary)
organisationIdstringID organisasi (buttons_summary)
duress_settings_writeDuress Configuration

Mengubah tetapan Duress: pelan tindak balas (di kemudahan, atau templat jenama atau organisasi), amaran peranti, peraturan kenalan jenama, dan destinasi penggera ke pusat pemantauan. Setiap perubahan meminta pengesahan kerana ia mengubah siapa yang dimaklumkan.

Hantar salah satu daripada facilityId (lalai: kemudahan yang disambungkan), brandId atau organisationId. Pelan kemudahan memerlukan Duress Configuration di sana; templat memerlukan pentadbir organisasi dengan Duress Configuration, atau bagi jenama, Duress Configuration di setiap kemudahan di dalamnya. Baca dahulu dengan duress_settings_read.

Tindakan:

  • save_response_plan: Simpan pelan tindak balas. Peringkat kenalan yang dimaklumkan afterSeconds selepas tekanan (menaik, yang pertama biasanya 0), ackRequired, reminders dan responseActions. Kemudahan boleh sebaliknya melanjutkan templatnya (mode extend) dengan tambahan. Medan yang ditinggalkan mengekalkan nilai yang disimpan; responseActions digabungkan mengikut tindakan. Meminta pengesahan.
  • remove_response_plan: Alih keluar pelan tindak balas. Memadamkan pelan yang disimpan di peringkat ini, supaya kemudahan kembali mengikut templatnya dan jenama kembali kepada templat organisasi. Meminta pengesahan.
  • save_device_alerts: Simpan amaran peranti. Menggantikan peraturan amaran peranti di peringkat ini: sehingga 10 peraturan, setiap satu ialah set peristiwa dan kenalan (push, sms atau email). Kekalkan id peraturan yang dibaca daripada duress_settings_read device_alerts. Memerlukan rules. Meminta pengesahan.
  • remove_device_alerts: Alih keluar amaran peranti. Memadamkan peraturan amaran peranti di peringkat ini, supaya ia kembali mengikut peringkat di atasnya. Meminta pengesahan.
  • save_contact_rules: Simpan peraturan kenalan jenama. Peranan yang boleh ditambah kepada pelan oleh kemudahan jenama: allowAllExcept menyembunyikan roleIds, manual hanya menawarkan roleIds. Kenalan yang sudah disimpan kekal; pelan diselesaikan dimuat semula. Memerlukan brandId, mode, roleIds. Meminta pengesahan.
  • save_monitoring: Simpan penghalaan pusat pemantauan. Destinasi penggera: eaAlarmType none, cid (memerlukan eaAlarmProvider, salah satu pembekal yang disenaraikan oleh duress_settings_read monitoring) atau relay (eaRelayModel). Memerlukan Duress Configuration di kemudahan tersebut. Memerlukan eaAlarmType. Meminta pengesahan.

Parameter

NamaJenisPenerangan
action*"save_response_plan" | "remove_response_plan" | "save_device_alerts" | "remove_device_alerts" | "save_contact_rules" | "save_monitoring"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_monitoring)
brandIdstringID jenama, untuk templat jenama dan bukannya kemudahan (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_contact_rules)
organisationIdstringID organisasi, untuk templat organisasi (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts)
mode"replace" | "extend"Pelan kemudahan sahaja: replace (peringkatnya sendiri) atau extend (tambahan kepada templat) (save_response_plan, save_contact_rules)
tiersarrayPeringkat pelan (mode replace dan templat) (save_response_plan)
additionsarrayMode extend: kenalan tambahan bagi setiap peringkat templat (tierId dan afterSeconds daripadanya) (save_response_plan)
ackRequiredbooleanSama ada peningkatan diteruskan sehingga seseorang mengakuinya (save_response_plan)
remindersobjectnullUlang amaran setiap everySeconds (0 mematikannya) sehingga stopAfterSeconds (save_response_plan)
responseActionsobjectTindakan mengikut nama, setiap satu { enabled, ... }: unlockOnAcknowledge (doorIds), lockdown, staffScreenAlerts, buttonAcknowledge, dashboardCctv, dashboardDoorControls, dashboardResolve, updateTexts, aiSummary, workflowControl, retainFootage (minutesBefore, minutesAfter, cameras) (save_response_plan)
rulesarrayPeraturan; senarai kosong tidak menyimpan apa-apa (tiada sesiapa dimaklumkan di sini) (save_device_alerts)
roleIdsarrayId peranan yang terpakai bagi mode (save_contact_rules)
eaAlarmType"none" | "cid" | "relay"none, cid atau relay (save_monitoring)
eaAlarmProviderstringnullUntuk cid: kod pembekal (save_monitoring)
eaRelayModel"none" | "numato-rl80001"Untuk relay: papan geganti (save_monitoring)
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_start_lockdownKecemasan

Mengenakan sekatan (lockdown) di kemudahan untuk penggera duress: setiap pintu berhenti membenarkan orang masuk sehingga sekatan ditarik balik (duress_lift_lockdown, atau dari konsol). Sesuatu penggera hanya boleh mempunyai satu sekatan.

Tidak sekali-kali untuk penggera ujian atau yang telah diselesaikan. Memerlukan Door/Gate Access di kemudahan tersebut.

Sahkan dahulu. Panggil tanpa confirm untuk menyemak insiden, beritahu pengguna bahawa setiap pintu akan dikunci, dan panggil semula dengan confirm: true setelah mereka bersetuju.

Parameter

NamaJenisPenerangan
incidentId*stringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress.
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_start_testKecemasan

Memulakan ujian duress di sesebuah kemudahan serta-merta. Sehingga ujian tamat, setiap tekanan ialah ujian, bukan penggera sebenar:

  • walk: kakitangan menekan setiap butang; hanya langkah pertama pelan tindak balas dimaklumkan, dilabelkan TEST.
  • drill: keseluruhan pelan tindak balas dijalankan, dilabelkan TEST.

Kenalan ujian kemudahan dimaklumkan bahawa ujian telah bermula dan menerima keputusan kira-kira 10 minit selepas ujian tamat. Satu ujian pada satu masa bagi setiap kemudahan. Tamatkan lebih awal dengan duress_end_test; tempah ujian lebih awal dengan duress_tests_write.

Sahkan dahulu. Panggil tanpa confirm, beritahu pengguna bahawa tekanan tidak akan mencetuskan penggera sebenar selama durationMinutes, dan panggil semula dengan confirm: true setelah mereka bersetuju. Dalam aliran kerja, atau daripada Ejen, ini hanya berfungsi jika pelan tindak balas kemudahan membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera.

Parameter

NamaJenisPenerangan
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan.
type"walk" | "drill"walk (lalai) atau drill
durationMinutesintegerTempoh tekanan dikira sebagai ujian (lalai 60)
monitoringCentreMode"test-codes" | "none"`test-codes` menghantar isyarat ujian ke pusat pemantauan; `none` tidak menghantar apa-apa kepadanya
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_tests_readKecemasanDuress Configuration

Membaca ujian butang duress: jadual yang menempahnya (walk, comms atau drill, sekali atau berulang, bagi organisasi, jenama atau kemudahan), tetingkap ujian yang diciptanya di setiap kemudahan (scheduled, active, completed, cancelled, serta ujian ad hoc), dan keputusan sesuatu tetingkap (butang yang ditekan atau terlepas, siapa yang dimaklumkan, isyarat pusat pemantauan, masa pengakuan).

Siapa yang menempah, mengubah atau membatalkan ujian tidak disertakan; penerima penghantaran disunting. Masa dalam format ISO; localDate dan localStartTime dalam zon waktu kemudahan. Tempah atau ubah ujian dengan duress_tests_write; mulakan ujian serta-merta dengan duress_start_test.

Tindakan:

  • schedules: Jadual ujian. scope facility (lalai; setiap jadual yang meliputinya, termasuk jadual dikongsi yang dilangkau atau digantikannya), brand (brandId) atau organisation (lalai: organisasi kemudahan tersebut). Perubahan terbaharu dahulu.
  • windows: Tetingkap ujian. Tetingkap ujian kemudahan dari from hingga to (lalai kira-kira seminggu ke belakang hingga sebulan ke hadapan), atau dengan organisationId sahaja, tetingkap akan datang organisasi merentas kemudahannya.
  • results: Keputusan ujian. Tetingkap dan keputusannya: disimpan setelah dihantar, dikira secara langsung semasa ujian berjalan (senarai semak ujian walk), null bagi tetingkap yang dijadualkan atau dibatalkan. Memerlukan Duress di kemudahan tersebut. Memerlukan startsAtKey.

Parameter

NamaJenisPenerangan
action*"schedules" | "windows" | "results"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
scope"facility" | "brand" | "organisation"Lalai facility (schedules)
facilityIdstringID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan.
brandIdstringID jenama, untuk templat jenama dan bukannya kemudahan (schedules)
organisationIdstringUntuk scope organisation (schedules, windows)
includeCancelledbooleanSertakan yang dibatalkan (schedules, windows)
limitintegerItem setiap halaman (lalai 25, maksimum 100) (schedules, windows)
cursorstringnextCursor daripada halaman sebelumnya (schedules, windows)
fromstringTarikh-masa ISO (windows)
tostringTarikh-masa ISO (windows)
startsAtKeystringTetingkap ujian (startsAtKey), daripada duress_tests_read windows (results)
duress_tests_writeDuress ConfigurationKecemasan

Menempah, mengubah dan membatalkan jadual ujian duress, menetapkan cara satu kemudahan mengikuti jadual yang dikongsi, dan membatalkan satu tetingkap ujian yang akan datang. Setiap perubahan menempah atau menulis semula tetingkap akan datang dan menghantar e-mel kepada pihak berkepentingan, jadi setiap satu meminta pengesahan.

Jadual memerlukan Duress Configuration ke atas keseluruhan sasarannya (pentadbir organisasi bagi jadual seluruh organisasi). Masa adalah dalam zon waktu setiap kemudahan. Baca jadual dan tetingkap dahulu dengan duress_tests_read; mulakan ujian sekarang dengan duress_start_test.

Tindakan:

  • create_schedule: Tempah jadual ujian. Menempah tetingkap sehingga kira-kira setahun ke hadapan di setiap kemudahan dalam target dan menghantar e-mel pengesahan tempahan. Memerlukan name, type, target, startDate, localStartTime dan recurrence. Memerlukan name, type, target, startDate, localStartTime, recurrence. Meminta pengesahan.
  • update_schedule: Ubah jadual ujian. Medan yang tidak dihantar mengekalkan nilainya. Tetingkap akan datang ditulis semula (yang telah bermula dibiarkan) dan pihak berkepentingan menerima notis perubahan. Gunakan ownerScope dalam hasil selepas itu. Memerlukan ownerScope, scheduleId. Meminta pengesahan.
  • cancel_schedule: Batalkan jadual ujian. Membatalkan jadual dan tetingkap akan datangnya, serta menghantar e-mel pembatalan. Kemudahan yang mempunyai salinan sendiri mengekalkannya. Memerlukan ownerScope, scheduleId. Meminta pengesahan.
  • set_facility_override: Ubah jadual dikongsi untuk satu kemudahan. mode follow (jalankan semula jadual dikongsi di sini), skip (hentikannya di sini) atau own (gantikannya di sini dengan salinan yang dibina daripada schedule). Memerlukan Duress Configuration di kemudahan itu sahaja. Memerlukan ownerScope, scheduleId, mode. Meminta pengesahan.
  • cancel_window: Batalkan satu tetingkap ujian. Membatalkan satu ujian berjadual di sesebuah kemudahan (jadual diteruskan) dan menghantar e-mel kepada pihak berkepentingannya. Memerlukan Duress di kemudahan itu; ujian yang sedang aktif ditamatkan dengan duress_end_test sebaliknya. Memerlukan startsAtKey. Meminta pengesahan.

Parameter

NamaJenisPenerangan
action*"create_schedule" | "update_schedule" | "cancel_schedule" | "set_facility_override" | "cancel_window"Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat.
namestringDipaparkan dalam e-mel dan kalendar (create_schedule, update_schedule)
type"walk" | "comms" | "drill"walk (tekan setiap butang), comms (satu tekanan bagi setiap laluan pemantauan) atau drill (respons yang dilatih) (create_schedule, update_schedule)
targetobjectKemudahan yang terlibat: seluruh organisasi, brandIds atau facilityIds (create_schedule, update_schedule)
startDatestringKejadian pertama, YYYY-MM-DD dalam zon waktu setiap kemudahan (create_schedule, update_schedule)
localStartTimestringHH:mm dalam zon waktu setiap kemudahan (create_schedule, update_schedule)
durationMinutesintegerLalai 60 (create_schedule, update_schedule)
recurrence"once" | "monthly" | "quarterly" | "twice-yearly" | "yearly"once, monthly, quarterly, twice-yearly atau yearly (create_schedule, update_schedule)
repeatOnobjectnullUlang pada hari bekerja ke-n dalam bulan itu dan bukannya pada tarikh yang sama; null mengosongkannya (create_schedule, update_schedule)
monitoringCentreMode"test-codes" | "none"test-codes menghantar isyarat sebagai ujian; none tidak melibatkan pusat pemantauan (create_schedule, update_schedule)
extraEmailsarrayTurut menerima e-mel tempahan, peringatan dan keputusan (create_schedule, update_schedule)
organisationIdstringLalai: organisasi kemudahan yang disambungkan (create_schedule, update_schedule, cancel_schedule, set_facility_override)
ownerScopestringDaripada jadual duress_tests_read, cth. brand#b-123; ia boleh berubah apabila sasaran berubah (update_schedule, cancel_schedule, set_facility_override)
scheduleIdstringDaripada jadual duress_tests_read (update_schedule, cancel_schedule, set_facility_override)
facilityIdstringID kemudahan. Pilihan apabila kemudahan yang disambungkan ialah kemudahan yang anda maksudkan. (set_facility_override, cancel_window)
mode"follow" | "skip" | "own"follow, skip atau own (set_facility_override)
scheduleobjectmode own: medan salinan (target sentiasa kemudahan ini); medan yang tidak dihantar diambil daripada jadual dikongsi (set_facility_override)
startsAtKeystringTetingkap ujian (startsAtKey), daripada tetingkap duress_tests_read (cancel_window)
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama
duress_unlock_doorsKecemasan

Membuka kunci pintu untuk penggera duress, cth. untuk membenarkan polis atau pasukan pertolongan cemas masuk: pintu yang dipautkan kepada butang yang ditekan, atau pintu pelan respons. Tinggalkan doorIds untuk semua pintu, atau senaraikan sebahagian daripadanya. Setiap buka kunci direkodkan dalam garis masa insiden dan dalam Access Logs.

Tidak sekali-kali untuk penggera ujian atau penggera yang telah diselesaikan. Memerlukan Door/Gate Access di kemudahan itu.

Sahkan dahulu. Panggil tanpa confirm untuk melihat pintu yang akan dibuka kuncinya, maklumkan kepada pengguna, dan panggil semula dengan confirm: true setelah mereka bersetuju.

Parameter

NamaJenisPenerangan
incidentId*stringID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress.
doorIdsarraySebahagian daripada pintu yang disenaraikan tanpa confirm. Tinggalkan untuk semua pintu.
confirmbooleanTetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama