Postman Collection + Environment untuk menguji Custom API FSC

Cara pakai (3 langkah cepat)

  1. Buka PostmanImport → pilih kedua file di atas.
  2. Pilih Environment “FSC – Dev” (kanan atas).
  3. Set variabel environment:
    • baseUrl → domain API kamu, contoh https://mydomain.com
    • airport → mis. CGK
    • typearrivals / departures
    • (opsional) apiKey, bearerToken, basicUser, basicPass

Yang sudah disiapkan dalam Collection

  • GET Flights (API Key in Query)
    {{baseUrl}}/api/flights?airport={{airport}}&type={{type}}&apikey={{apiKey}}

  • GET Flights (API Key in Header)
    Header: Authorization: ApiKey {{apiKey}}

  • GET Flights (Bearer Token)
    Header: Authorization: Bearer {{bearerToken}}

  • GET Flights (Basic Auth)
    Auth tab: Basic (pakai basicUser/basicPass)

Semua request sudah punya tests bawaan:

  • Status 200
  • Response JSON
  • Ada properti flights berupa array

Tips & Best Practice

  • Pastikan endpoint kamu mengembalikan struktur:

    { "flights": [ { "time": "...", "flight": "...", "airline": "...", "route": { "from": {...}, "to": {...} }, "status": "ON TIME" } ] }
  • Gunakan waktu format ISO 8601 (YYYY-MM-DDTHH:mm:ssZ).

  • Jika tidak ada data, kembalikan {"flights":[]} (bukan error 500) agar FSC menampilkan “No flights found”.

  • Cek cepat rate limit/kuota API provider jika respons kosong atau tidak lengkap.

Postman Collection versi lanjutan (folder per provider + negative tests + pre‑request script) beserta environment contoh.

Download:

Apa isi yang baru?

  • Folder per provider:

    • Custom API (Query API key, Header API key, Bearer, plus Negative – Missing key).
    • OpenSky (demo endpoint publik untuk sanity check).
    • AviationStack (arrivals + Negative – invalid key).
    • AeroDataBox via RapidAPI (arrivals + Negative – missing RapidAPI key).
    • FlightAware AeroAPI (arrivals + Negative – invalid key).
  • Pre-request script global:

    • Set nowIso otomatis.
    • Isi type default (arrivals sebelum jam 12, departures setelahnya) jika kosong.
    • Warning jika baseUrl belum diisi untuk request Custom API.
  • Tests bawaan di tiap request:

    • 200 OK, response JSON, dan ada flights array.
    • Negative cases mengecek status 401/403.

Cara pakai singkat

  1. Import kedua file ke Postman.

  2. Pilih environment “FSC – Providers (Sample)”.

  3. Isi key sesuai provider:

    • aviationstackKey, rapidapiKey, flightawareKey

    • Untuk Custom API: baseUrl, apiKey / bearerToken / basicUser+basicPass

  4. Jalankan request sesuai provider yang kamu gunakan.

  5. Kalau sukses, respons JSON sebaiknya punya struktur:

    { "flights": [ { "time": "...", "flight": "...", "airline": "...", "route": { "from": {...}, "to":