---
title: "Developer API"
summary: "API read-only resmi Lensiro: tarik data penjualan, pelanggan, dan gudang ke sistem Anda sendiri — dashboard keuangan, Google Sheets, CRM, atau agent AI."
slug: developer-api
product: LENSIRO
source: https://lensiro.com/dokumentasi/developer-api
updated: 2026-08-23
---

# 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

```bash
curl -H "Authorization: Bearer lsk_live_xxxx" \
  "https://app-anda.lensiro.com/api/v1/ping"
```

```json
{ "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.


---

Dokumentasi Lensiro · https://lensiro.com/dokumentasi/developer-api · diperbarui 23 Agustus 2026