Bab 13
Developer API
API read-only resmi Lensiro: tarik data penjualan, pelanggan, dan gudang ke sistem Anda sendiri — dashboard keuangan, Google Sheets, CRM, atau agent AI.
Lensiro menyediakan REST API read-only: alamat web khusus yang mengeluarkan data toko Anda dalam format JSON, supaya bisa ditarik ke sistem lain secara otomatis — tanpa web scraping, tanpa export manual, dan tanpa ikut rusak setiap kali tampilan Lensiro diperbarui.
Untuk siapa halaman ini
Untuk developer atau tim IT yang diminta menyambungkan Lensiro ke sistem lain. Anda tidak perlu tahu isi dapur Lensiro — cukup bisa memanggil URL dan membaca JSON. Semua contoh di bab ini bisa disalin apa adanya.
Kalau Anda pemilik toko dan hanya ingin tahu apa yang mungkin, cukup baca halaman ini lalu teruskan tautannya ke tim teknis Anda.
Yang bisa dibangun
| Kebutuhan | Endpoint yang dipakai |
|---|---|
| Rekap omzet harian otomatis ke Google Sheets | /sales |
| Dashboard keuangan / arus kas per metode bayar | /sales/payments |
| Monitoring pekerjaan faset (Fasset) | /sales/facets |
| Sinkronisasi pelanggan ke CRM atau alat WhatsApp blast | /members |
| Kartu stok & nilai persediaan di sistem akuntansi | /warehouse/stocks, /warehouse/stock-movements |
| Agent AI yang bisa ditanyai "omzet cabang X minggu lalu berapa?" | semuanya |
Tiga hal yang perlu diketahui sebelum mulai
1. API ini hanya membaca (GET). Tidak ada endpoint untuk membuat, mengubah, atau menghapus data. Sistem Anda tidak akan pernah bisa merusak data Lensiro lewat API ini. Metode selain GET dijawab 405.
2. Base URL-nya milik Anda sendiri. Setiap klien Lensiro punya server sendiri, jadi tidak ada satu alamat API global. Base URL Anda adalah alamat yang Anda pakai untuk login, ditambah /api/v1:
https://app-anda.lensiro.com/api/v1
Di seluruh dokumentasi ini alamat tersebut ditulis sebagai {BASE}.
3. Butuh API key. Semua request wajib membawa API key. Key dibuat sendiri oleh admin toko dari menu Pengaturan → API Key di dalam aplikasi. Caranya ada di halaman Autentikasi & Batas Pemakaian.
Contoh 30 detik
curl -H "Authorization: Bearer lsk_live_xxxx" \
"https://app-anda.lensiro.com/api/v1/ping"
{ "ok": true, "key_name": "Integrasi Google Sheets" }
Kalau balasan itu yang muncul, koneksi dan key Anda sudah benar — tinggal lanjut ke halaman Mulai Cepat.
Cara membaca bab ini
Urutan yang disarankan: Mulai Cepat → Autentikasi & Batas Pemakaian → Konvensi Respons & Paginasi. Setelah itu buka halaman domain data yang Anda butuhkan (Penjualan / Pelanggan / Gudang), dan pakai Referensi Endpoint sebagai contekan sehari-hari.
Ringkasan format: JSON, semua nama field
snake_case, semua tanggal ISO 8601 UTC, semua nilai uang berupa angka Rupiah bulat tanpa desimal.
Di bab ini
- Mulai CepatLima langkah dari nol sampai data penjualan pertama masuk ke sistem Anda, lengkap dengan perintah yang bisa disalin.
- Autentikasi & Batas PemakaianCara membuat dan memakai API key (Bearer lsk_live_...), arti setiap error 401, batas 60 request/menit per key, dan praktik keamanan.
- Konvensi Respons & PaginasiAturan yang berlaku di semua endpoint: bentuk envelope, snake_case, tanggal UTC, paginasi cursor, sinkronisasi updated_since, dan penanda data terhapus.
- Referensi EndpointContekan satu halaman: seluruh endpoint v1, parameter yang diterima masing-masing, bentuk respons, dan dukungan paginasi.
- API Penjualan (Sales)Endpoint /sales beserta item dan pembayaran yang menyatu, cara membaca blok amounts, ledger pemasukan /sales/payments, dan pekerjaan faset /sales/facets.
- API Pelanggan (Members)Endpoint /members: profil pelanggan, level member, saldo dan mutasi poin, serta riwayat belanja per pelanggan.
- API Gudang (Warehouse)Endpoint /warehouse: katalog barang, stok per cabang sebagai snapshot, dan riwayat barang masuk/keluar beserta cara merekonsiliasinya.
- Panduan Integrasi & Contoh KodeResep polling yang benar (backfill, updated_since, upsert, tombstone) plus contoh kode siap pakai untuk Google Apps Script, Python, dan Node.js.
- Kode Error & Pemecahan MasalahDaftar lengkap kode error beserta penyebabnya, kebijakan percobaan ulang, dan jawaban untuk masalah yang paling sering muncul.
- Glosarium & Daftar EnumPadanan istilah Indonesia ke nama field API, plus daftar lengkap nilai enum yang bisa muncul di respons.
- Batasan, Versi & RencanaApa yang sengaja tidak ada di API v1 dan alasannya, janji kompatibilitas versi, serta daftar rencana pengembangan berikutnya.
