OpenSandbox
OpenSandboxDokumentasi
Dokumentasi Resmi OpenSandbox

Panduan Lengkap Membangun & Mengintegrasikan REST API Visual

Pelajari cara membuat endpoint REST API dinamis, merancang alur logika percabangan, menghubungkan external service, serta mengintegrasikannya ke dalam aplikasi web & mobile Anda.

Lihat Contoh Kode

1. Pengenalan Platform OpenSandbox

OpenSandbox adalah visual backend platform yang dirancang untuk memudahkan software engineer, frontend developer, mobile engineer, dan tester dalam membuat, menguji, dan mendeploy endpoint REST API nyata tanpa perlu mengelola server backend atau menulis kode boilerplate.

Instan Tanpa Deploy

Setiap perubahan alur logika langsung aktif seketika di endpoint publik Anda.

Validasi & Keamanan

Dukungan validasi skema body, query parameter, dan otorisasi API key.

Reusable Logic

Shared functions memungkinkan Anda mendaur ulang logika antar puluhan endpoint.

2. Format & Struktur URL Endpoint

Setiap endpoint yang Anda buat pada OpenSandbox memiliki alamat URL publik unik berformat:

https://api-sandbox.adysanjaya.my.id/demo_user123/cek-status

● Host API: https://api-sandbox.adysanjaya.my.id — Server eksekusi REST API berkecepatan tinggi dengan reverse proxy SSL.

● User Hash: demo_user123 — Pengenal unik workspace akun Anda agar tidak terjadi bentrok nama slug dengan pengguna lain.

● Slug: cek-status — Path kustom yang Anda tentukan sendiri saat membuat endpoint (misal: users, checkout, trx).

3. Cara Membuat Endpoint Baru

  1. 1
    Buka Menu Endpoints: Klik tombol + New Endpoint pada dashboard atau navigasi sidebar.
  2. 2
    Tentukan Nama & Method: Masukkan nama deskriptif (contoh: Cek Saldo Member) dan pilih HTTP Method yang sesuai:
    GETPOSTPUTDELETEPATCH
  3. 3
    Tentukan Slug: Gunakan karakter huruf kecil, angka, dan strip (contoh: cek-saldo).
  4. 4
    Rancang Alur Node: Susun node pada Flow Builder kanvas, lalu hubungkan garis konektor dari Trigger hingga ke Response.
  5. 5
    Simpan & Uji: Klik tombol Save dan lakukan pengujian langsung menggunakan tombol Test atau tombol Salin URL untuk diuji melalui Postman atau cURL.

4. Panduan Node pada Visual Flow Builder

Trigger Node (Input Request)

Node awal yang bertindak sebagai gerbang masuk ketika klien memanggil API. Menangkap seluruh payload request:

request.headers — Header HTTP dari klien (misal: Authorization, User-Agent)

request.query — Query string URL (misal: ?status=active&limit=10)

request.body — Objek JSON atau teks yang dikirimkan klien

Condition / Branching Node (Logika Percabangan)

Mengevaluasi kondisi if-else. Memiliki dua jalur output: True dan False. Contoh: Memeriksa apakah saldo cukup, apakah role pengguna adalah admin, atau apakah parameter wajib sudah disertakan.

HTTP Request Node (Eksternal API)

Melakukan panggilan HTTP ke layanan pihak ketiga (misal: WhatsApp Gateway, Payment Gateway, Database REST API). Data respons dapat ditangkap dan diteruskan ke node berikutnya.

Response Node (Output Akhir)

Menghasilkan respons HTTP final yang dikembalikan ke pemanggil API. Anda dapat menentukan:

HTTP Status Code — 200 OK, 201 Created, 400 Bad Request, 401 Unauthorized, 404 Not Found, 500 Internal Error

Content-Type — application/json, text/plain, text/html, application/xml

Response Body — JSON kustom atau variabel hasil pemrosesan node sebelumnya

5. Fungsi Logika Bersama (Shared Functions)

Jika Anda memiliki alur logika yang sering digunakan di banyak endpoint (misalnya verifikasi API Token, pengecekan waktu operasional, atau validasi format nomor telepon), Anda dapat membuatnya sekali di menu Shared Functions dan memasukkannya ke berbagai flow endpoint menggunakan node Shared Function.

6. Contoh Integrasi Kode Multibahasa

Gunakan URL endpoint Anda yang telah disalin
curl -X POST "https://api-sandbox.adysanjaya.my.id/demo_user123/cek-status" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "ORD-9921", "amount": 150000}'

7. Monitoring & Metrik Hit API

Pada halaman Dashboard, sistem secara otomatis merekam dan memvisualisasikan seluruh panggilan API yang masuk ke endpoint Anda secara real-time:

  • Total Panggilan: Jumlah akumulatif hit dalam rentang waktu 24 jam, 7 hari, atau 30 hari.
  • Success Rate (%): Rasio respons sukses (HTTP 2xx) dibanding total request.
  • Rata-rata Latensi (ms): Kecepatan eksekusi pemrosesan flow visual dalam milidetik.
  • Top Endpoint: Peringkat endpoint yang paling banyak diakses beserta persentase traffic share.

8. Tanya Jawab (FAQ) & Bantuan

Apakah endpoint OpenSandbox mendukung CORS?

Ya. Semua endpoint secara default telah menyertakan header CORS lengkap sehingga dapat langsung dipanggil dari browser (React, Vue, Angular, mobile app, dll).

Bagaimana jika saya membutuhkan bantuan teknis khusus?

Anda dapat menggunakan tombol Kontak Bantuan di sidebar atau header dashboard untuk menghubungi tim pengembang kami langsung via WhatsApp atau Email.