Menghubungkan perangkat lunak sendiri dengan kunci API

API publik memungkinkan perangkat lunak Anda atau pengembang Anda membaca dan menulis catatan Kluvan: produk, pelanggan, stok, laporan, dokumen Pembukuan, orang di SDM, CRM, langganan, dan aplikasi yang Anda miliki. Anda mengendalikan setiap kunci: apa yang boleh dilakukan, berapa lama, dan untuk cabang mana.

Sebelum memulai

• Hanya pemilik yang dapat membuat dan mencabut kunci.
• Kunci tidak pernah membuka aplikasi yang tidak dimiliki organisasi, dan semua aturan paket, aplikasi, serta cabang tetap berlaku.

Langkah-langkah

1. Buka Pengaturan → Akses pengembang.
2. Di Kunci baru, ketik Nama yang mudah dikenali, misalnya "Pemindai gudang".
3. Atur Berlaku selama hari (1–365). Nilai bawaannya 90.
4. Di Cabang, biarkan Semua cabang atau pilih satu cabang.
5. Di Dapat melihat, centang setiap cakupan yang diperlukan kunci. Masing-masing bertuliskan Baca atau Tulis, misalnya Produk · Baca.
6. Centang kalimat yang menyatakan Anda mengizinkan akses terpilih.
7. Tekan Buat kunci.
8. Salin kunci sekarang. Kunci hanya ditampilkan sekali ini.
9. Berikan kunci kepada perangkat lunak Anda. Perangkat lunak mengirimkannya dalam header Authorization: Bearer.

Memanggil API

• Alamatnya https://api.kluvan.com/v1/public-api. Panduan pengembang (/developers) menampilkan contoh dan setiap operasi beserta cakupan yang diperlukan. OpenAPI 3.1 mengunduh kontrak lengkap dengan bidang permintaan.
• Setiap penulisan memerlukan Idempotency-Key: UUID baru per perubahan. Jika jawaban hilang, kirim ulang permintaan yang sama dengan kunci yang sama hingga 7 hari; perubahan tidak diterapkan dua kali. Kunci yang sama dengan permintaan yang berubah akan ditolak.
• Perubahan pada catatan yang ada juga mengirim versi catatan saat ini (v), sehingga salinan lama tidak menimpa yang baru.
• Jumlah memakai satuan mata uang terkecil (150.00 adalah 15000).
• Daftar catatan aplikasi mengembalikan hingga 50 catatan dan nilai next; kirim nilai itu sebagai after untuk mendapatkan halaman berikutnya.
• Hingga 120 permintaan per menit per kunci. Setelah itu, jawabannya 429 dengan Retry-After. Setiap kesalahan memiliki kode (lihat panduan kesalahan).

Perlu diketahui

• Cakupan tulis mengubah catatan nyata dan dapat menjalankan tindakan aplikasi beserta dampaknya pada stok dan akuntansi. Berikan hanya cakupan yang diperlukan kunci.
• Kunci cabang hanya membaca catatan cabang. Operasi katalog, pelanggan, CRM, SDM, dan langganan memerlukan kunci untuk semua cabang.
• Kluvan hanya menyimpan sidik jari (hash) setiap kunci. Kehilangan kunci? Cabut dan buat yang baru.
• Cabut langsung menghentikan kunci. Kunci juga berhenti pada hari terakhirnya. Anda dapat memiliki hingga 20 kunci.
• Aktivitas API mencantumkan setiap panggilan: waktu, operasi, kunci, dan status. Isi permintaan dan kunci tidak pernah dicatat.
• API tidak menyediakan penagihan, masuk, penerimaan pembayaran, atau webhook: tidak ada notifikasi keluar, sehingga perangkat lunak Anda membaca daftar yang diperlukan.
• Sesi peramban yang sudah masuk tidak dapat memanggil API ini, dan kunci aplikasi asisten terpisah: lihat menghubungkan aplikasi asisten.