Panduan cepat (5 menit)

Tujuan: berangkat dari instalasi baru dan sampai pada sebuah permintaan terautentikasi yang URL dan tokennya berasal dari variabel. Perkirakan lima menit.

1. Membuat proyek

File ▸ Baru (Ctrl+N), lalu File ▸ Simpan sebagai (Ctrl+Shift+S) untuk memberinya nama, misalnya demo.restorm.

Sebuah proyek hanyalah satu file di disk Anda. Anda sudah bisa meletakkannya di dalam repositori git sejak sekarang — Restorm memang dirancang untuk itu.

2. Membuat folder variabel

Klik kanan di pohon samping ▸ Tambah ▸ Folder variabel.

Sebuah folder variabel (atau folder lingkungan) adalah wadah yang membawa lingkungan Anda — local, staging, production — dan karenanya juga {{variabel}} Anda. Semua permintaan di dalamnya mewarisi lingkungan yang sedang dipilih.

Bukalah folder itu, buat lingkungan local, dan tambahkan sebuah variabel:

Kunci	Tipe	Nilai
baseUrl	String	https://api.exemple.test

3. Membuat dan mengirim permintaan

Klik kanan pada folder ▸ Tambah ▸ Permintaan HTTP. Di dalam tab yang terbuka:

• biarkan metodenya pada GET;
• masukkan URL {{baseUrl}}/health — nilai hasil resolusinya muncul di bawah kolom, itulah jaring pengaman Anda;
• klik Send.

Responsnya terbuka di bawah: status, waktu, ukuran, header, dan body yang ditampilkan dalam penampil JSON yang dapat dilipat.

4. Menambahkan autentikasi

Alih-alih menempelkan token secara permanen, buatlah sebuah permintaan autentikasi: klik kanan ▸ Tambah ▸ Permintaan autentikasi. Konfigurasikan panggilan yang memperoleh token (misalnya sebuah POST /oauth/token), lalu di tab Konfigurasi-nya, deklarasikan apa yang dihasilkannya:

Header yang dihasilkan	Nilai
Authorization	{{token_type}} {{access_token}}

Nilainya adalah ekspresi yang dievaluasi terhadap body respons dari permintaan autentikasi tersebut. Isi sekalian ekspresi masa berlakunya (misalnya {{expires_in}}) agar Restorm memperbarui tokennya sendiri.

Kembalilah ke permintaan GET Anda dan, di bilah atas, pilih rute autentikasi tersebut. Headernya kini disuntikkan pada setiap pengiriman, dan sebuah 401 otomatis memicu pembaruan token lalu percobaan ulang.

Selengkapnya: Autentikasi.

5. Melangkah lebih jauh

• Sudah punya spesifikasi atau koleksi? File ▸ Impor (Ctrl+I) membangun ulang seluruh pohonnya: lihat Impor & ekspor.
• Rangkaikan beberapa panggilan dan periksa hasilnya dengan sebuah skenario.
• Jalankan skenario itu di CI Anda: Eksekusi headless.