Developer Hub & REST API Docs

API Platform v1.0 Production

Pusat Dokumentasi & Integrasi REST API

Hubungkan aplikasi pihak ketiga, OTA (Online Travel Agent), scanner gate fisik, POS kasir, e-commerce, dan sistem otomatisasi eksternal ke ekosistem toko secara aman dan real-time.

Base Endpoint: https://toko.rumren.id/api

Otentikasi: Header X-API-KEY

Format Data: application/json

Daftar Modul REST API & Webhook

Pilih modul API di bawah ini untuk melihat panduan teknis, parameter, dan live playground interaktif.

Ready / Aktif

E-Tiket & Reservasi

Validasi barcode tiket, gerbang turnstile otomatis (Gate-In), penerbitan tiket OTA luar, dan sinkronisasi reservasi.

4 Endpoint Buka Dokumentasi

Ready / Aktif

Katalog Produk & Stok

Tarik daftar produk, varian harga, kategori bisnis, stok live, dan status ketersediaan item untuk sinkronisasi katalog.

3 Endpoint Buka Dokumentasi

Ready / Aktif

Pesanan & Transaksi POS

Pembuatan order langsung, update status pembayaran (QRIS/Transfer), tracking resi pesanan, dan rekap transaksi kasir.

4 Endpoint Buka Dokumentasi

Ready / Aktif

Pelanggan & Poin Member

Pengecekan akun member, saldo poin loyalitas, histori pesanan pelanggan, dan penyesuaian poin dari sistem eksternal.

3 Endpoint Buka Dokumentasi

Google Apps Script

Webhook Google Sheets (Auto-Sync)

Simpan otomatis pesanan, booking tiket, dan Custom Fields toko langsung ke Google Spreadsheet dengan proteksi Throttling & Anti-Spam.

Script + Live Tester Buka Panduan

Otentikasi & Keamanan API (Master API Key)

Setiap toko memiliki Master API Key (X-API-KEY) unik yang dapat Anda atur secara mandiri di halaman pengaturan toko. Header ini wajib disertakan dalam setiap request API untuk mengamankan data transaksi antar-toko.

Standard HTTP Headers

X-API-KEY: [MASTER_API_KEY_TOKO_ANDA]
Content-Type: application/json
Accept: application/json

Kelola API Key di Pengaturan Toko

Standar Status Response HTTP

Seluruh respon API menggunakan standar format JSON dengan kode status HTTP umum berikut.

HTTP Code	Status	Keterangan & Arti Respon
200 OK	`success`	Permintaan berhasil diproses. Data hasil dikembalikan dalam objek JSON.
201 Created	`success`	Data baru (booking, order, tiket) berhasil dibuat dan tersimpan ke database.
400 Bad Request	`error`	Parameter yang dikirim tidak lengkap atau format payload JSON tidak valid.
401 Unauthorized	`error`	Header `X-API-KEY` kosong atau tidak disertakan pada request.
403 Forbidden	`error`	API Key salah / tidak cocok dengan Master Key toko yang terdaftar.
404 Not Found	`error`	Data tiket, booking, atau nomor transaksi yang dicari tidak ditemukan.
500 Server Error	`error`	Terjadi kendala internal server saat mengeksekusi operasi database.