Lewati ke konten utama

Quick Start

tip

Mulai sekarang juga dan lakukan request API pertama Anda untuk mengambil daftar kendaraan di sini.

Memulai dengan Cartrack Fleet API cukup sederhana. Bagian ini menyediakan contoh dasar untuk melakukan API call pertama Anda. Walaupun contoh ini menggunakan curl, alat yang fleksibel dan didukung luas untuk melakukan HTTP request dari command line, prinsipnya bisa diterapkan ke bahasa pemrograman dan tool lain seperti Python, JavaScript, atau HTTP client library lainnya.

Prasyarat​

Sebelum melanjutkan, pastikan Anda memiliki:

  • cURL terpasang: Pastikan cURL sudah terpasang di sistem Anda. cURL biasanya tersedia di Unix, Linux, dan macOS, serta dapat diinstal di Windows.
  • Base URL dan Authentication Credentials: Anda memerlukan base URL Cartrack Fleet API dan credentials yang valid. Untuk panduan detail mendapatkannya, lihat bagian Authentication dan Base URLs pada dokumentasi kami.

Melakukan API Call​

Berikut cara melakukan API call untuk mengambil daftar kendaraan menggunakan curl:

curl --location '{baseUrl}/rest/vehicles' \
--header 'Accept: application/json' \
--header 'Authorization: Basic your_encoded_credentials'

Ganti {baseUrl} dengan base URL aktual Cartrack Fleet API, dan ganti your_encoded_credentials dengan kredensial otorisasi Anda yang sudah di-encode Base64.

Memahami Command​

  • --location: Menginstruksikan curl untuk mengikuti redirect yang dikirim server sebagai bagian dari HTTP request.
  • --header: Digunakan untuk menentukan header tambahan pada request. Dalam contoh ini, kita menentukan penerimaan response berformat JSON dan menyertakan kredensial otorisasi.
  • URL endpoint ({baseUrl}/rest/vehicles) menentukan endpoint API untuk mengambil daftar kendaraan.

Response​

API akan mengembalikan response JSON yang berisi daftar kendaraan, masing-masing dengan detail seperti vehicle ID, model, dan informasi relevan lainnya.

Contoh dasar ini memberikan kerangka awal untuk melakukan API call ke Cartrack Fleet API. Anda dapat menyesuaikan contoh ini dengan bahasa pemrograman atau tool pilihan Anda berdasarkan prinsip yang sama. Untuk informasi lebih detail tentang fungsionalitas API dan endpoint tambahan, lanjutkan eksplorasi dokumentasi API kami.

Import ke Postman​

Anda dapat mengimpor spesifikasi OpenAPI Cartrack ke Postman untuk menghasilkan koleksi request yang siap digunakan.

  • Spec URL: https://developer.cartrack.com/openapi/openapi.yaml
  • Di Postman: klik Import → Link, tempel URL, lalu klik Import. Atau gunakan Import → File dan unggah file openapi.yaml yang sudah diunduh.
  • Postman akan membuat koleksi request berdasarkan spec.
  • Konfigurasikan nilai environment:
    • Atur base URL sesuai panduan di halaman Base URLs.
    • Konfigurasikan authentication: API Cartrack menggunakan Basic Authentication. Di Postman, buka request apa pun, masuk ke tab Authorization, pilih Basic Auth, lalu isi username dan password. Alternatifnya, tambahkan header Authorization dengan nilai Basic <base64-encoded-credentials>. Lihat halaman Authentication untuk detail pembuatan credentials.
  • Jalankan request individual atau gunakan Collection Runner untuk mengeksekusi banyak call.