Integrasi dan API

Early Warning dirancang untuk berada di dalam lingkungan yang sudah ada, bukan di sampingnya. Data tiba sesuai jadwal dari sumber yang Anda daftarkan, metrik dan peringatan keluar melalui API yang terdokumentasi, dan seluruh produk berjalan di infrastruktur yang Anda kendalikan.

Tidak ada yang serba khusus pada jalur integrasinya. API yang dipakai antarmuka tersedia juga untuk skrip dan layanan Anda, sehingga sebuah operasi dapat mengotomatiskan diri terhadap platform tanpa menunggu konektor ditulis.

Ingest dikelola sebagai konfigurasi, bukan kode. Sumber didaftarkan bersama jadwal dan endpoint-nya, dan setiap eksekusi dicatat, sehingga celah pada data menjadi terlihat sebelum berubah menjadi celah pada peringatan.

• Registri sumber dengan jadwal per sumber dan pemicuan sesuai permintaan.
• Riwayat eksekusi dan log per sumber, sehingga kegagalan dapat didiagnosis, bukan senyap.
• Impor lapisan geospasial eksternal seperti layanan FeatureServer dan berkas GeoJSON.
• Metrik didefinisikan atas data yang sudah ada, tanpa salinan kedua.

Pembacaan dan penulisan melewati permukaan API berversi yang sama, sehingga dasbor, skrip, dan aturan melihat angka yang sama. Tidak ada salinan pelaporan yang perlu diselaraskan, dan tidak ada ekspor yang diam-diam menua sementara sumbernya bergerak.

• Endpoint REST untuk nilai terkini, seri, metrik, peringatan, dan statusnya.
• Akses berautentikasi token, sehingga integrasi mesin teridentifikasi dan dapat dicabut.
• Ekspor CSV dan GeoJSON atas data di balik sebuah tampilan atau kueri.
• Laporan PDF yang dihasilkan untuk briefing yang masih berpindah sebagai dokumen.

Integrasi yang lazim berukuran kecil. Sebuah skrip membaca nilai terkini sebuah metrik sesuai jadwal lalu menerbitkannya ke sistem lain, atau perkakas internal menuliskan sebuah peristiwa melalui API dan membiarkan aturan yang memutuskan apakah itu penting.

Permukaannya sengaja tidak hanya baca. Rekaman seperti kartu papan, peristiwa, dan titik data kustom dapat dibuat serta diperbarui melalui endpoint berautentikasi yang sama, dengan pemeriksaan peran yang juga berlaku di antarmuka.

• Baca metrik atau seri sesuai jadwal lalu terbitkan di tempat lain.
• Tuliskan peristiwa dari sistem internal, agar aturan juga mengawasinya.
• Tarik peringatan ke kanal operasional tanpa sumber kebenaran kedua.

Akses dibatasi berdasarkan peran dan API tertutup secara bawaan: endpoint menuntut kredensial, bukan mengandalkan batas jaringan. Tindakan administratif dan perubahan yang menyangkut keamanan ditulis ke jejak audit.

Hal itu paling penting ketika data peringatannya sensitif. Siapa yang boleh membaca seri, siapa yang boleh mengubah aturan, dan siapa yang menindaklanjuti peringatan semuanya pertanyaan yang bisa dijawab, tanpa bergantung pada ingatan seseorang.

Produk berjalan di dalam lingkungan Anda sendiri — aplikasi, basis data, dan API bersama-sama — dengan inferensi tetap lokal alih-alih dialihkan ke model eksternal. Data operasional tidak perlu meninggalkan jaringan untuk diberi skor, diberi peringatan, atau dilaporkan.

Penerapannya adalah tumpukan kecil yang dapat Anda hos sendiri, sehingga jalur datanya pendek dan tanggung jawab operasionalnya jelas. Tidak ada perantara pihak ketiga antara sumber data Anda dan peringatan yang Anda terima.

Infrastruktur Anda, basis data Anda, jalur data Anda — tanpa perantara pihak ketiga.

Integrasi yang berhasil pada hari ditulis belum selesai. Sumber berubah, kredensial kedaluwarsa, dan eksekusi yang berhenti mengirim data hanya tidak berbahaya bila ada yang menyadarinya, karena itu setiap sumber menyimpan riwayat eksekusi serta log kegagalannya sendiri.

Kredensial diterbitkan per integrasi dan dapat dicabut satu per satu, sehingga mencabut satu konsumen cukup satu tindakan, bukan perburuan. API-nya sendiri berversi, sehingga pembaruan menjadi perubahan yang ditinjau, bukan kejutan.

• Periksa log eksekusi sebuah sumber seperti Anda memeriksa dasbornya.
• Terbitkan kredensial terpisah untuk setiap integrasi dan cabut saat konsumennya pensiun.
• Perlakukan perubahan versi API sebagai perubahan terjadwal yang diuji.

Awal tercepat adalah mendaftarkan satu sumber yang endpoint-nya sudah Anda miliki, memastikan log eksekusinya, lalu membangun satu aturan di atasnya. Setelah itu ekspor, konsumen API, dan papan respons semuanya mengikuti pola yang sama.

Bawa endpoint beserta kredensialnya, dan integrasi pertama biasanya selesai serta terverifikasi dalam satu sesi. Selebihnya adalah pengulangan pola yang sudah dipahami tim Anda.