API ini memungkinkan sistem internal perusahaan Anda dan AI (seperti chatbot buatan sendiri, portal internal, atau sistem bisnis) mencari dan membaca SOP Dive yang sudah terbit. API dipanggil dengan kunci (API key) yang diterbitkan oleh Pemilik. Setiap jawaban menyertakan tautan yang membuka SOP tersebut di Dive.
Jika seseorang ingin mencari dan membaca SOP dengan akun Dive miliknya sendiri dari AI yang ia gunakan (seperti Claude atau ChatGPT), gunakan Koneksi AI (MCP). API adalah fitur yang membaca dari sistem perusahaan Anda dengan kunci perusahaan. Orang yang menggunakan sistem Anda tidak memerlukan akun Dive (mereka perlu login ke Dive untuk membuka video).
Tersedia pada paket Enterprise. Pemilik menerbitkan dan mengatur kunci dari browser PC. Fitur ini disediakan sebagai versi beta.
Catatan: Sebelum menggunakan fitur ini, pastikan Anda membaca "Persyaratan Kepatuhan dan Penafian" di bagian bawah artikel ini. Jika Anda menggunakan fitur ini, Anda dianggap telah menyetujui isinya.
Yang dapat dilakukan API
Dengan API, Anda hanya dapat mencari dan membaca SOP. Anda tidak dapat membuat, mengubah, atau menghapus SOP.
- Cari: Kirim kata pencarian, dan API akan mengembalikan SOP yang sudah terbit yang cocok, diurutkan berdasarkan tingkat kecocokan. API mencari di judul SOP, nama langkah, isi pekerjaan, tips, kualitas, keselamatan, barang yang dipakai, nomor dokumen, tag, teks SOP berbasis file, dan teks keterangan video. Untuk setiap hasil yang cocok, API menyertakan kutipan bagian yang cocok dan tautan yang membuka SOP di Dive
- Baca: Mengembalikan judul SOP, nomor dokumen, ringkasan, barang yang dipakai, dan judul file terkait, beserta isi pekerjaan, tips, kualitas, keselamatan, dan waktu standar untuk setiap langkah. Untuk SOP berbasis file (manual yang sudah ada seperti PDF), API mengembalikan teks dari setiap halaman. Setiap langkah menyertakan tautan yang membuka langkah tersebut di Dive
API hanya mengembalikan SOP yang sudah terbit dalam cakupan kunci (lihat "Cakupan SOP yang dikembalikan kunci" di bawah). Draf tidak dikembalikan. Video, gambar, dan isi file terkait juga tidak dikembalikan. Pertanyaan dalam SOP serta nama orang, seperti penulis, juga tidak dikembalikan.
Sebelum memulai (Pemilik menerbitkan kunci)
Pemilik menerbitkan kunci dari browser PC.
- Buka [Fungsi Pemilik] dari menu samping
- Pilih tab [Integrasi] di bagian atas, lalu buka [API (mencari dan membaca SOP)] (berada di bawah [Koneksi AI (MCP)])
- Klik [Terbitkan kunci]
- Tentukan nama, Grup yang ditampilkan, IP sumber, dan masa berlaku, lalu klik [Terbitkan] (untuk arti masing-masing, lihat "Yang perlu ditentukan untuk setiap kunci" di bawah)
- Kunci yang diterbitkan akan ditampilkan. Salin kunci dan [URL API] ke pengaturan sistem perusahaan Anda, lalu klik [Sudah disalin, tutup]
Kunci hanya ditampilkan sekali, tepat setelah diterbitkan. Setelah layar ditutup, kunci tidak dapat ditampilkan lagi. Jika lupa menyalin, cabut kunci tersebut dan terbitkan kunci baru. Jangan sertakan kunci dalam tangkapan layar (screenshot).
Ketika kunci diterbitkan, email pemberitahuan bahwa kunci tersebut telah diterbitkan akan dikirim kepada semua Pemilik tim. Jika Anda menerima pemberitahuan tentang kunci yang diterbitkan dan Anda tidak mengenalnya, cabut kunci tersebut dengan mengikuti langkah pada "Ubah atau cabut kunci" di bawah.
Kartu ini juga ditampilkan pada paket selain Enterprise. Jika Anda mengklik [Terbitkan kunci], pemberitahuan tentang paket akan ditampilkan.
Yang perlu ditentukan untuk setiap kunci
- Nama: Nama yang menunjukkan sistem mana yang menggunakan kunci ini (maksimal 60 karakter). Contoh: "Chatbot internal (produksi)"
- Grup yang ditampilkan: Menentukan cakupan SOP yang dikembalikan oleh kunci. Lihat "Cakupan SOP yang dikembalikan kunci" di bawah
-
IP sumber: Alamat internet keluar dari server yang memanggil API (tempat sistem perusahaan Anda berjalan). Setelah didaftarkan, hanya panggilan dari alamat tersebut yang diterima. Anda dapat mendaftarkan hingga 20 entri, satu per baris, berupa alamat IPv4 atau rentang /16 hingga /32 (misalnya,
203.0.113.0/24). Wajib untuk tim yang menggunakan pembatasan alamat IP - Masa berlaku: Pilih 30 hari, 90 hari, atau 1 tahun (bawaan 1 tahun). Kunci berakhir pada tanggal masa berlakunya, pada jam yang sama dengan saat diterbitkan. Masa berlaku tidak dapat diperpanjang
Satu tim dapat memiliki hingga 5 kunci aktif. Jika tim sudah memiliki 5 kunci, cabut kunci yang tidak digunakan lagi untuk menerbitkan kunci baru.
Cakupan SOP yang dikembalikan kunci (Grup yang ditampilkan)
Kunci hanya mengembalikan SOP yang sudah terbit yang dapat dilihat oleh Pengguna hanya-lihat yang menjadi anggota semua grup yang dipilih di [Grup yang ditampilkan] saat mencari di Dive. SOP di folder yang tidak dibatasi grup selalu dikembalikan.
- Jika tidak ada grup yang dipilih, hanya SOP di folder yang tidak dibatasi grup yang dikembalikan
- Jika Anda memilih beberapa grup, cakupan ditentukan seolah-olah "satu orang yang menjadi anggota semua grup yang dipilih". Ini dapat menghasilkan cakupan yang lebih luas daripada gabungan rentang yang dapat dilihat masing-masing grup
- Cakupan ini tidak sama dengan yang dapat dilihat oleh Pemilik dan Admin Tim (semua SOP). SOP di folder yang tidak dapat dilihat oleh grup mana pun tidak dikembalikan
- Pengaturan [Cakupan tampilan folder] tim berlaku untuk kunci sama seperti untuk Pengguna hanya-lihat (Memungkinkan akses ke folder subgrup (Cakupan tampilan folder))
- Jika grup yang dipilih dihapus, grup tersebut diperlakukan seolah-olah tidak ada
Cakupan dapat diperiksa dengan ikon kaca pembesar [Uji dengan kunci ini] pada baris kunci. Masukkan kata lalu klik [Cari], dan hasil pencarian dalam cakupan kunci tersebut (judul SOP dan folder) akan ditampilkan. [Uji dengan kunci ini] tidak dihitung sebagai panggilan API.
Memanggil API
Panggil API melalui HTTPS dari server perusahaan Anda. API tidak dapat dipanggil langsung dari layar browser (JavaScript), karena kunci akan terlihat di halaman.
- URL API:
https://api.divedx.com/v1 - Spesifikasi (OpenAPI 3.0):
https://api.divedx.com/v1/openapi.json(dapat dibaca tanpa kunci) - Cara mengirim kunci: tambahkan
Authorization: Bearer kunci-Andake header
Respons mungkin menyertakan kolom baru di masa mendatang. Buat sistem Anda agar melewati kolom yang tidak dikenali. Selama API berada dalam versi beta, format respons dapat berubah.
Cari SOP
Kirim kata pencarian (query, maksimal 200 karakter) dan jumlah hasil yang ingin dikembalikan (limit, 1 hingga 20, default 5) dalam format JSON ke POST /procedures/search.
curl -X POST https://api.divedx.com/v1/procedures/search \
-H "Authorization: Bearer dapi_..." \
-H "Content-Type: application/json" \
-d '{"query":"fryer cleaning","limit":5}'
Daftar SOP dikembalikan berdasarkan tingkat kecocokan. Jika tidak ada yang cocok, daftar kosong ("results": []) akan dikembalikan.
{
"results": [
{
"id": "-NaBcD1",
"versionId": "-NxYzW9",
"version": 3,
"title": "Fryer cleaning",
"documentNumber": "QC-012",
"folder": "Cleaning",
"kind": "steps",
"language": "en",
"updatedAt": "2026-10-01T09:30:00+09:00",
"matches": [{ "field": "safety", "step": 3, "text": "…after the oil has cooled…" }],
"url": "https://app.divedx.com/view/-NxYzW9?step=3"
}
],
"requestId": "req_…"
}
| Item | Keterangan |
|---|---|
id |
ID SOP. ID tidak berubah saat SOP direvisi. Gunakan saat membaca SOP |
versionId dan version
|
ID dan nomor versi yang sedang diterbitkan |
title, documentNumber, dan folder
|
Judul SOP, nomor dokumen, dan nama folder tempat SOP disimpan |
kind |
steps (SOP yang dibagi menjadi langkah) atau file (SOP berbasis file) |
language |
Bahasa asli SOP (misalnya, ja, en, atau zh-CN) |
matches |
Lokasi yang cocok (kolom, nomor langkah atau halaman, dan kutipan). Maksimal 3 per hasil |
url |
Tautan yang membuka SOP di Dive (Anda perlu login ke Dive). Jika sebuah langkah cocok, tautan membuka dari langkah tersebut |
Baca SOP
Gunakan GET /procedures/{id} dengan id (atau versionId) dari hasil pencarian untuk membaca SOP. API selalu mengembalikan versi yang sedang diterbitkan.
curl https://api.divedx.com/v1/procedures/-NaBcD1 \ -H "Authorization: Bearer dapi_..."
Kolom utama yang dikembalikan adalah sebagai berikut.
- Judul, nomor dokumen, ringkasan (
description), barang yang dipakai (usedItems: nama, nomor produk, jumlah, satuan), dan file terkait (relatedFiles: hanya judul dan jenis file yang diatur untuk ditampilkan kepada pembaca) - Langkah (
steps): nomor dan nama langkah, isi pekerjaan (work), tips (tips), kualitas (quality), keselamatan (safety), waktu standar (standardTimeSec, dalam detik), dan tautan yang membuka langkah tersebut di Dive (url) - Untuk SOP berbasis file (
kindadalahfile), teks dari setiap halaman (pages). Untuk file yang teksnya tidak dapat dibaca, seperti PDF hasil pindai,noteakan memberi tahu Anda
SOP yang panjang akan dipotong di tengah saat dikembalikan. Jika truncated bernilai true, panggil API lagi dengan fromStep yang ada di next (untuk SOP berbasis file, fromPage) untuk mendapatkan sisanya. Anda juga dapat menentukan rentang yang akan dibaca dengan fromStep, toStep, fromPage, dan toPage. Jika sebuah kolom panjang, kolom tersebut dipotong pada 4.000 karakter (satu halaman SOP berbasis file dipotong pada 8.000 karakter) dan "…" ditambahkan di akhir.
Jika SOP tidak ada, berada di luar cakupan kunci, atau hanya berupa draf, API akan mengembalikan 404.
Batas jumlah panggilan
- Setiap kunci dibatasi 120 panggilan per menit dan sekitar 20.000 panggilan per hari (waktu Jepang). Setiap tim dibatasi 600 panggilan per menit
- Jika batas terlampaui, API akan mengembalikan 429. Tunggu sejumlah detik yang tertera di header
Retry-After, lalu panggil lagi - Jika panggilan dilakukan berulang kali dari sumber yang sama dengan kunci yang tidak terdaftar, API juga akan mengembalikan 429 untuk beberapa waktu
Saat terjadi kesalahan
Kesalahan dapat dikenali dari kode status HTTP dan code di badan respons (dalam format RFC 9457). Saat menghubungi kami, mohon sampaikan header X-Request-Id dari respons (sama dengan requestId di badan respons).
| Status | code | Penyebab utama dan tindakan |
|---|---|---|
| 400 | invalid_request |
Badan permintaan tidak dapat dibaca, berisi kolom yang tidak dikenali, atau nilainya di luar rentang yang diizinkan. Periksa data yang Anda kirim |
| 401 | invalid_key |
Kunci tidak ada atau salah. Periksa format header (Authorization: Bearer kunci-Anda) |
| 401 | key_expired |
Masa berlaku kunci telah habis. Terbitkan kunci baru dan ganti kunci lama |
| 401 | key_revoked |
Kunci telah dicabut. Terbitkan kunci baru dan ganti kunci lama |
| 403 | plan |
Paket tim tidak memungkinkan penggunaan API (tersedia pada paket Enterprise) |
| 403 | ip_not_allowed |
Panggilan berasal dari luar alamat IP sumber yang didaftarkan untuk kunci |
| 403 | ip_required |
Tim menggunakan pembatasan alamat IP, tetapi belum ada alamat IP sumber yang didaftarkan untuk kunci |
| 403 | forbidden |
Panggilan berasal dari browser. Panggil API dari server perusahaan Anda |
| 404 | not_found |
SOP tidak ada, berada di luar cakupan kunci, hanya berupa draf, atau URL salah |
| 405 | method_not_allowed |
Metode HTTP salah (POST untuk pencarian, GET untuk membaca) |
| 413 | payload_too_large |
Badan permintaan terlalu besar (maksimal 16 KB) |
| 429 | rate_limited |
Batas jumlah panggilan telah terlampaui. Tunggu sejumlah detik yang tertera di Retry-After
|
| 503 | unavailable |
Sementara tidak dapat diproses. Tunggu sebentar lalu panggil lagi |
Melihat penggunaan (Pemilik)
Buka [Penggunaan] pada kartu [API (mencari dan membaca SOP)] untuk melihat, per kunci, Jumlah pencarian, Jumlah dibaca, dan Kesalahan yang dibuat melalui API selama 7 hari, 30 hari, dan 90 hari terakhir. Anda juga dapat melihat Jumlah dibaca untuk setiap SOP. Detail yang mencakup kata-kata yang dicari dapat diekspor dari [Ekspor detail sebagai CSV].
Panggilan yang ditolak karena masa berlaku kunci, paket, IP sumber, atau batas jumlah panggilan juga dihitung sebagai "Kesalahan", dengan maksimal satu kali per menit untuk kunci dan alasan yang sama. Jika panggilan dari sistem internal Anda berhenti, Anda dapat memeriksanya di sini.
Catatan panggilan disimpan selama 400 hari. Catatan penerbitan, perubahan, dan pencabutan kunci, serta ekspor detail sebagai CSV, juga tercatat dalam log audit (Ekspor log audit sebagai CSV). Pemilik dapat memeriksa kata-kata yang dicari melalui API. Pemberitahuan kepada orang yang menggunakan sistem Anda menjadi tanggung jawab Anda.
Ubah atau cabut kunci
- Nama, Grup yang ditampilkan, dan IP sumber dapat diubah dari ikon pensil (ubah) pada baris kunci. Nilai kunci dan masa berlaku tidak dapat diubah
- Untuk mencabut kunci, klik ikon tempat sampah (Cabut kunci) pada baris kunci, lalu klik [Cabut kunci] pada tampilan konfirmasi. Kunci yang sudah dicabut tidak dapat dipulihkan
- Perubahan dan pencabutan berlaku untuk panggilan API dalam sekitar 30 detik
- Kunci yang sudah dicabut dan kunci yang sudah kedaluwarsa ditampilkan dalam daftar selama 30 hari
Masa berlaku dan penggantian
Pemilik diberi tahu melalui email 30 hari dan 7 hari sebelum masa berlaku berakhir (untuk kunci dengan masa berlaku 30 hari, hanya 7 hari sebelumnya). Karena masa berlaku tidak dapat diperpanjang, terbitkan kunci baru, ganti kunci di pengaturan sistem perusahaan Anda, lalu cabut kunci lama. Selama masa penggantian, kunci baru dan kunci lama keduanya dapat digunakan.
Saat mengubah paket atau mulai menggunakan pembatasan alamat IP
- Jika Anda beralih dari Enterprise ke paket lain, panggilan API akan ditolak (
plan). Kunci tetap ada dan dapat digunakan kembali seperti semula setelah Anda kembali ke Enterprise. Melihat daftar kunci dan mencabut kunci tetap dapat digunakan setelah paket diubah - Jika Anda mulai menggunakan pembatasan alamat IP nanti, kunci yang tidak memiliki alamat IP sumber terdaftar tidak dapat digunakan lagi (
ip_required). Daftarkan alamat IP dari ikon pensil pada baris kunci agar kunci dapat digunakan kembali - Alamat IP yang didaftarkan ke sebuah kunci hanya berlaku untuk kunci tersebut. Alamat tersebut tidak ditambahkan ke daftar izin (allowlist) pembatasan alamat IP tim, dan tidak memengaruhi login biasa
Pertanyaan yang sering diajukan
Q. Apa perbedaan antara Koneksi AI (MCP) dan API?
A. Koneksi AI memungkinkan AI dalam daftar, seperti Claude atau ChatGPT, membaca SOP dengan hak akses akun Anda yang terhubung (paket Lite, Core, Pro, dan Enterprise). API memungkinkan sistem buatan sendiri membaca SOP dalam cakupan kunci yang diterbitkan oleh Pemilik (paket Enterprise).
Q. Apakah SOP yang dibaca melalui API tercatat di riwayat tampilan?
A. Tidak. Pembacaan melalui API tidak dihitung dalam riwayat tampilan, status Mandiri, atau evaluasi keterampilan otomatis. Anda dapat memeriksa penggunaan API di [Penggunaan].
Q. Isi revisi yang baru saja diterbitkan tidak dikembalikan.
A. Selama beberapa menit setelah penerbitan, API mungkin mengembalikan teks versi sebelumnya. Tunggu sebentar lalu panggil lagi.
Q. Apakah saya bisa menerima teks terjemahan?
A. Tidak. API mengembalikan SOP dalam bahasa aslinya. Anda dapat mengetahui bahasa asli dari language.
Q. Apakah saya bisa mendapatkan daftar SOP secara lengkap sekaligus?
A. Tidak. API dirancang untuk mencari dan membaca SOP saat dibutuhkan. Tujuannya agar salinan SOP tidak disimpan di dalam perusahaan Anda sehingga SOP yang usang tidak tertinggal di sana: setiap kali, API membaca versi terbaru yang sudah diterbitkan di Dive.
Q. Apakah bisa digunakan dari platform AI di dalam perusahaan saya?
A. Jika platform dapat membaca spesifikasi OpenAPI (3.0) dan memanggil API dengan kunci di header Authorization, Anda dapat mendaftarkan API sebagai alat. Untuk cara pendaftarannya, silakan lihat bantuan platform yang Anda gunakan.
Persyaratan Kepatuhan dan Penafian
Fitur ini menghubungkan sistem Anda dengan Dive. Ketentuan Penggunaan Dive berlaku untuk penggunaannya, dan Persyaratan Kepatuhan dan Penafian dalam bagian ini berlaku sebagai tambahan atas ketentuan tersebut. Mohon pastikan untuk membaca butir-butir berikut dan menggunakan fitur ini setelah Anda menyetujuinya. Jika Anda menggunakan fitur ini, Anda dianggap telah menyetujui butir-butir berikut.
Hal-hal yang berkaitan dengan sistem Anda dan layanan pihak ketiga, seperti platform AI yang Anda gunakan (desain, pengembangan, konfigurasi, operasi, perilaku, gangguan, dan isi jawaban), berada di luar cakupan yang dapat kami tangani, sehingga tidak termasuk dalam dukungan. Selain itu, karena fitur ini berada dalam versi beta, pertanyaan tentang perilaku Dive juga akan ditangani hanya sejauh yang dapat kami lakukan, atas pertimbangan kami.
1. Pengelolaan kunci
(1) Kunci adalah kunci perusahaan yang dapat membaca teks SOP tim. Mohon kelola nilai kunci dengan ketat atas tanggung jawab Anda sendiri. Jangan letakkan kunci pada layar yang berjalan di browser, kode sumber yang dipublikasikan, obrolan, email, atau tempat sejenis lainnya.
(2) Jika kunci bocor atau ada kemungkinan bocor, segera cabut kunci dan terbitkan kunci baru. Kami menyarankan untuk mendaftarkan alamat IP sumber.
(3) Segera cabut kunci yang tidak lagi digunakan.
(4) Kami tidak bertanggung jawab atas kerugian yang timbul akibat kelalaian dalam pengelolaan kunci atau sebab serupa lainnya.
2. Cakupan SOP yang diberikan, dan orang yang menggunakan sistem Anda
(1) Cakupan SOP yang dikembalikan oleh kunci ditentukan oleh grup yang dipilih Pemilik untuk setiap kunci dan pengaturan tampilan folder tim. Mohon periksa cakupan dengan [Uji dengan kunci ini] dan atur atas tanggung jawab Anda sendiri.
(2) Teks SOP yang dikembalikan oleh API akan sampai kepada orang yang menggunakan sistem Anda (termasuk orang yang tidak memiliki akun Dive). Mohon kelola tampilan, penyimpanan, dan cakupan pengguna di sistem Anda atas tanggung jawab Anda sendiri.
(3) Kata-kata yang dicari melalui API dan SOP yang dibaca akan dicatat, dan Pemilik dapat memeriksanya. Mohon beri tahu orang yang menggunakan sistem Anda atas tanggung jawab Anda sendiri.
(4) Kami tidak bertanggung jawab atas kebocoran informasi atau kerugian lain yang disebabkan oleh pengaturan cakupan atau kelalaian dalam pengelolaan sistem Anda.
3. Akurasi jawaban dari sistem dan AI Anda
(1) Jawaban yang dibuat oleh sistem atau AI Anda berdasarkan teks yang dikembalikan API dapat mengandung ringkasan, parafrasa, penghilangan, atau kesalahan. AI juga dapat menambahkan isi yang tidak tertulis dalam SOP saat menjawab.
(2) Sebelum melakukan pekerjaan atau mengambil keputusan, selalu periksa SOP asli melalui tautan Dive yang dilampirkan pada jawaban. Terutama, jangan mengambil keputusan mengenai hal-hal yang berkaitan dengan keselamatan dan kualitas hanya berdasarkan jawaban dari sistem atau AI.
(3) Kami tidak bertanggung jawab atas hasil pekerjaan atau keputusan yang diambil berdasarkan jawaban dari sistem atau AI Anda, maupun atas kecelakaan atau kerugian yang timbul darinya.
4. Penafian terkait penggunaan layanan pihak ketiga
Layanan pihak ketiga yang Anda gunakan untuk terhubung dengan API (seperti platform AI dan layanan cloud) disediakan berdasarkan ketentuan yang ditetapkan oleh masing-masing penyedia. Penyimpanan, penggunaan, dan penggunaan ulang teks SOP yang dikirim ke layanan tersebut, termasuk untuk pelatihan model AI, mengikuti ketentuan dan pengaturan masing-masing penyedia. Mohon pastikan atas tanggung jawab Anda sendiri bahwa pengaturan seperti penonaktifan pelatihan (opt-out) telah diterapkan. Kami tidak menjamin keamanan jalur komunikasi, kerahasiaan informasi, ketersediaan, atau legalitas layanan tersebut. Kami tidak bertanggung jawab atas gangguan, penghentian, atau perubahan spesifikasi layanan tersebut, maupun atas masalah keamanan atau kerugian yang timbul dari penggunaannya.
5. Tanpa jaminan, perubahan, dan penghentian
(1) Fitur ini disediakan sebagai versi beta, dan kami tidak memberikan jaminan apa pun mengenai kelengkapan, akurasi, ketersediaan, kegunaan, keamanan, tidak dilanggarnya hak pihak ketiga, maupun kesesuaian untuk tujuan tertentu.
(2) Kami dapat mengubah isi dan spesifikasi fitur ini (termasuk format respons dan batas panggilan) serta paket yang dapat menggunakan fitur ini tanpa pemberitahuan, atau menghentikan sementara atau mengakhiri penyediaan fitur ini. Kami tidak bertanggung jawab atas kerugian yang timbul bagi Anda akibat hal-hal tersebut. Mohon gunakan fitur ini atas penilaian dan tanggung jawab Anda sendiri setelah memeriksa informasi terbaru.
6. Kepatuhan terhadap hukum dan ketentuan
Saat menggunakan fitur ini, Anda wajib mematuhi hukum yang berlaku, Ketentuan Penggunaan Dive, ketentuan layanan pihak ketiga yang Anda gunakan, dan peraturan internal perusahaan Anda.
Terkait
Mencari dan membaca SOP Dive dari obrolan AI yang Anda gunakan, seperti Claude dan ChatGPT (MCP)
Memungkinkan akses ke folder subgrup (Cakupan tampilan folder)