> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplus.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Pengenalan API

> Kenali API Simplus untuk menghubungkan sistem kamu dan mengelola data Simplus secara otomatis.

API Simplus memungkinkan sistem kamu membaca dan memperbarui data Simplus secara otomatis, tanpa harus input manual.

## Apa itu API?

API (Application Programming Interface) adalah jalur komunikasi antara sistem kamu dan Simplus. Sistem kamu mengirim permintaan (request), lalu Simplus membalas dengan data (response) dalam format JSON.

Contoh pemakaian:

* Sinkronisasi produk dan stok dengan marketplace atau website toko.
* Menarik data penjualan ke software akuntansi atau ERP.
* Membuat dashboard atau laporan internal sendiri.

## Apa itu API key?

Setiap permintaan ke API Simplus wajib membawa **API key**. API key adalah kunci rahasia yang menandakan permintaan itu benar-benar dari kamu.

* **Izin bisa diatur**: setiap API key punya izin (permission) sendiri, misalnya hanya boleh melihat produk.
* **Bisa dibatasi per outlet**: kunci bisa dikunci ke satu outlet saja.
* **Ditampilkan sekali**: kunci hanya muncul saat dibuat, jadi simpan di tempat yang aman.

Kirim API key sebagai bearer token di header setiap permintaan:

```bash theme={null}
curl https://app.simplus.id/... \
  -H "Authorization: Bearer <API_KEY_KAMU>"
```

<Warning>
  Jangan bagikan API key dan jangan simpan di repository publik. Kalau kunci bocor, segera hapus lalu buat yang baru.
</Warning>

## Langkah berikutnya

<CardGroup cols={2}>
  <Card title="Membuat API Key" icon="key" href="/integration/api-key">
    Buat API key pertama kamu dari aplikasi Simplus.
  </Card>

  <Card title="API Reference" icon="code" href="https://registry.scalar.com/@simplus/apis/public">
    Lihat daftar lengkap endpoint Simplus beserta contoh request dan response.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.