Septalabs API Documentation

Welcome! This guide provides a simple, layman-friendly explanation on how to connect your applications to the Septalabs Virtual Tour ecosystem. Selamat datang! Panduan ini disusun dengan bahasa yang sangat mudah dimengerti (bahkan untuk pemula) agar Anda dapat menyambungkan aplikasi Anda dengan ekosistem Septalabs Virtual Tour.

POST

Login (Authentication) Masuk (Autentikasi)

Use this feature to log into the system. In return, the system will give you a 'Secret Token'. You MUST include this token in all other requests to prove who you are. Gunakan fitur ini untuk masuk ke dalam sistem. Sebagai balasannya, sistem akan memberikan Anda sebuah 'Token Rahasia'. Anda WAJIB membawa token ini di setiap perintah selanjutnya sebagai bukti identitas.

https://vr.septalabs.com/api/login

Required Data to SendData yang Wajib Dikirim

Field NameNama Kolom	Type	DescriptionPenjelasan (Bhs Manusia)
`username` *	TextTeks	Your registered usernameNama pengguna akun Anda
`password` *	TextTeks Rahasia	Your account passwordKata sandi akun Anda

System ResponsesBalasan Sistem

CODE 200 Success! You are in.Berhasil! Anda masuk.

token: The secret key to use in other API calls. Keep it safe!Kunci rahasia untuk dipasang di perintah lain. Jangan sebarluaskan!
login_url: A magic link to auto-login without password.Tautan ajaib untuk langsung masuk (auto-login) tanpa perlu mengetik kata sandi lagi.

CODE 201 User is blocked.Akun Anda sedang diblokir oleh Admin.

CODE 202 Incorrect password.Kata sandi yang Anda masukkan salah.

CODE 203 Incorrect username.Nama pengguna tidak ditemukan.

POST

Register New Account Daftar Akun Baru

Register a brand new user from outside the application (e.g. from your own landing page). Gunakan fitur ini jika Anda ingin membuatkan form pendaftaran (*Sign Up*) di website Anda sendiri tanpa harus repot menyuruh pelanggan masuk ke halaman bawaan Septalabs.

https://vr.septalabs.com/api/register

Data Field	Type	Description
`username` *	TextTeks	Desired usernameNama akun yang dimau (tanpa spasi)
`email` *	Email formatFormat Email	User's emailEmail aktif milik pelanggan
`password` *	TextTeks	Desired passwordKata sandi yang dimau
`id_plan`	NumberAngka ID	Subscription Plan ID (Optional)ID Paket Langganan (Boleh dikosongkan)

CODE 200 Registered successfully!Berhasil Mendaftar!

id_user: The unique ID of the new user.Nomor KTP (ID Unik) milik pengguna baru tersebut di sistem.
validate_mail: True/False if email validation is required.Benar/Salah (Jika sistem mewajibkan verifikasi email sebelum bisa login).

CODE 201 Username is already taken.Maaf, nama pengguna itu sudah dipakai orang lain.

CODE 202 Email is already registered.Email ini sudah pernah didaftarkan.

GET

List All Users Ambil Daftar Pengguna

Fetch a list of all registered users. Requires Admin Token Fitur ini berguna untuk menarik data buku tamu seluruh pengguna yang ada di database.
Hanya bisa dilakukan jika Anda Login sebagai Administrator

https://vr.septalabs.com/api/users?token=YOUR_TOKEN

Data Field	Description
`token` *	Your secret admin tokenToken rahasia Admin Anda
`limit`	Max records to show (e.g. 10)Mau tampilkan berapa data? (Opsional, misal: 50)
`offset`	Start from which record (e.g. 10)Mulai dari data ke berapa? (Guna untuk pagination halaman)

CODE 200 Success. The `data` property will contain a list of users.Berhasil. Sistem akan mengembalikan objek bernama `data` berisi sekumpulan akun.

CODE 404 Users not found / Database is empty.Kosong. Tidak ada siapapun di database ini.

GET

Tour Statistics Statistik Tur

Get real-time analytics and viewer counts for virtual tours. Tarik laporan lengkap terkait berapa banyak orang yang telah melihat tur virtual Anda hari ini!

https://vr.septalabs.com/api/tour_stats?token=YOUR_TOKEN&id_tour=5

Data Field	Description
`token` *	Your secret tokenToken rahasia Anda saat login
`id_tour`	Specific Tour ID (Leave blank to get ALL stats)ID spesifik tur (Kosongkan jika mau menarik data total semua tur)

CODE 200 Success. Contains chart data and view counts.Berhasil ditarik. Berisi data grafik dan jumlah penonton.

CODE 404 Tour ID not found.Tidak ada tur dengan ID tersebut.