Integrasi
Buka hub Integrasi Panel Admin untuk menyambungkan EventHub, konektor gudang data, dan Konsol API. Ketersediaan tergantung pada rencana dan peluncuran.
Hub Integrations di Panel Admin adalah tempat administrator menghubungkan PetroBench ke sistem data perusahaan dan membuka API Console untuk organisasi.
Permukaan Panel Admin ini sedang diluncurkan dan mungkin belum muncul di setiap organisasi. Jika diaktifkan untuk paket Anda, Anda akan menemukannya di Admin Panel > API & Integrations. Panduan pengaturan mendalam ada di Integrasi Perusahaan.
Buka Integrasi
- Beralih ke Admin Panel
- Buka API & Integrations > Overview (label mungkin ditampilkan sebagai Integrations)
- Tinjau konektor unggulan dan daftar kategori (Minyak & Gas, Cloud & Data, Identitas & Akses, dan grup terkait)
Hub menunjukkan total integrasi yang tersedia dan terhubung ketika organisasi Anda memiliki akses.
Apa yang Anda kelola di sini
| Daerah | Tujuan |
|---|---|
| Connector catalog | Telusuri integrasi yang tersedia untuk organisasi Anda |
| Connection status | Lihat konektor mana yang diaktifkan atau segera hadir |
| EventHub | Buka konfigurasi sinkronisasi dan catat koneksi gudang yang aktif |
| API Console | Token layanan, webhook, penggunaan, dan konfigurasi koneksi klien |
Kunci API pribadi masih ada di Pengaturan. Hub Panel Admin adalah permukaan pengembang tingkat organisasi.
EventHub dan sinkronisasi gudang
Untuk alur kerja EventHub, Snowflake, dan sinkronisasi terkait, gunakan panduan Perusahaan:
Dari Panel Admin Anda biasanya:
- Buka kartu integrasi yang terhubung
- Tinjau pemetaan lapangan, jadwal sinkronisasi, dan log sinkronisasi terkini
- Selesaikan peninjauan kecocokan peralatan saat konektor mengantri kecocokan dengan keyakinan rendah
Kecocokan peralatan dengan tingkat kepercayaan lebih rendah dari sinkronisasi masuk dimasukkan dalam antrean untuk ditinjau oleh admin sehingga teknisi tidak secara diam-diam mendapatkan unit pemompaan atau tingkatan batang yang salah.
Konsol API
API Console adalah beranda dalam aplikasi untuk akses API organisasi. Buka Admin Panel > API & Integrations > API Console.
Ini mencakup empat tab:
| Tab | Tujuan |
|---|---|
| Service Tokens | Membuat dan mengelola token milik divisi untuk server dan pekerjaan |
| Webhooks | Daftarkan titik akhir HTTP untuk peristiwa platform |
| Usage | Volume permintaan langsung, batas paket, dan kuota bulanan |
| Connect | Konfigurasi siap salin untuk CLI, klien MCP, dan REST |
Penggunaan
Usage menunjukkan volume permintaan API, kuota, dan konsumsi token untuk periode saat ini.
Kartu tipikal meliputi:
- Jumlah permintaan organisasi dan pribadi, waktu respons rata-rata, dan tingkat kesalahan
- Plan limits - permintaan per menit, agregat divisi, proses bersamaan, batas atas token harian
- Monthly quotas - membaca, menulis, menjalankan simulasi, dan pengiriman webhook
- Daily activity ditambah titik akhir teratas dan konsumen saat lalu lintas ada
Gunakan tab ini saat mendiagnosis batas kecepatan, tekanan kuota, atau kesalahan API yang tidak terduga. Lihat juga Batas tarif.
Token Layanan
Service Tokens adalah kredensial berumur panjang yang dimiliki oleh division, bukan seseorang. Mereka terus bekerja setelah penciptanya pergi.
Membuat token layanan
- Buka Admin Panel > API & Integrations > API Console
- Buka tab Service Tokens
- Klik Create service token
- Masukkan Token name (misalnya,
Nightly Snowflake Sync) - Pilih Expiration (30 hari, 90 hari, atau 1 tahun)
- Secara opsional atur IP allowlist
- Pilih Permissions (cakupan) untuk Sumur, Simulasi, Peralatan, dan Organisasi
- Klik Create service token
- Segera salin token teks biasa - token hanya ditampilkan sekali
Dari menu baris Anda dapat mengganti nama, memutar, atau mencabut token. Setiap divisi memiliki jumlah token aktif yang dibatasi (ditampilkan sebagai total penggunaan dalam daftar).
Lebih memilih token layanan untuk pekerjaan terjadwal dan integrasi. Lebih memilih kunci API pribadi hanya ketika seorang teknisi memanggil API secara interaktif.
Detail autentikasi lengkap: Otentikasi API.
Webhook
Webhooks mendaftarkan titik akhir HTTP yang dipanggil PetroBench ketika peristiwa terjadi (misalnya, well.created atau simulation.failed).
- Buka tab Webhooks
- Klik Add Webhook
- Masukkan URL titik akhir dan pilih acara
- Simpan, lalu gunakan kontrol kirim/uji untuk memverifikasi pengiriman
Hubungkan
Tab Connect membantu Anda mengarahkan CLI, klien MCP (Claude, ChatGPT, Cursor), cURL, atau Python ke ruang kerja Anda. Salin konfigurasi untuk klien Anda, lalu ganti placeholder kunci API dengan token layanan atau kunci pribadi.
Untuk pengaturan klien langkah demi langkah, lihat Memulai dan Referensi MCP.
Siapa yang dapat mengakses
| Aksi | Admin Kantor Pusat | Admin Divisi | Admin Wilayah |
|---|---|---|---|
| Lihat hub Integrasi | Ya | Bervariasi berdasarkan paket | Tidak |
| Konfigurasikan EventHub | Ya | Bervariasi berdasarkan paket | Tidak |
| Buka Konsol API (Penggunaan, Koneksi) | Ya | Ya (divisi sendiri) | Tidak |
| Kelola Token Layanan | Ya | Ya (divisi sendiri) | Tidak |
| Kelola Webhook | Ya | Ya (divisi sendiri) | Tidak |
Terkait
- Aplikasi untuk aplikasi yang diinstal dan pemberdayaan pasar
- Memulai API
- Otentikasi API
- Batas nilai
- RBAC untuk siapa yang dapat mengelola pengaturan organisasi