[[apikey]]
 

API KEY

Saat pertama kali mendaftar, masing-masing pengguna dilengkapi dengan Kunci Penghubung atau yang sering disebut dengan API Key. Kunci ini diperlukan sebagai identifikasi aliran data tanpa harus melibatkan Nama Pakai (username) dan Kata Sandi (password) yang sifatnya sangat rahasia.

Request

Jumlah permintaan data dengan API ini (API Request) akan dicatat oleh sistem secara kumulatif dari keseluruhan aplikasi termasuk versi web, mobile, facebook, wordpress, dan lainnya.
Pecatatan dilakukan untuk setiap permintaan:

  • Berdasarkan Refresh Rate pada Dashboard aplikasi web Elyez.com, bukan oleh interval GPS.
  • Berdasarkan jumlah permintaan pada aplikasi web mobile.
  • Berdasarkan Refresh Rate pada aplikasi lainnya hasil pengembangan oleh maupun di luar tim Elyez.

Cara menghitung API Request:

Pada Dashboard, Refresh Rate penampilan adalah 30 detik.

Dalam 1 hari, aplikasi dibuka selama 5 jam akumulatif.

Maka dalam 1 hari jumlah permintaan API Request adalah:
	API Request Harian = 5 jam x 3600 detik รท 30 detik/request
	API Request Harian = 600 request

Dan dalam 1 bulan (periode recycle) adalah:
	API Request Bulanan = 30 hari x 600 request
	API Request Bulanan = 18000 request

Karakteristik

  • API Key sifatnya unik dan berbeda untuk setiap user.
  • Keterikatan berdasarkan pengguna, bukan unit GPS
  • Terdiri dari kumpulan string (angka dan huruf), minimal 16 karakter
  • Hanya dapat digunakan untuk transmisi data yang diperbolehkan layanan Elyez
  • Bersifat rahasia apabila Anda tidak ingin sharing data, bersifat umum apabila Anda ingin membagi kewenangan
  • Dibuat pada saat pendaftaran anggota baru, sampai saat ini hanya Administrator yang dapat merubah kunci Anda

Kunci Saya

Secara standar, tanpa ada perubahan pada menu (sidebar) di kiri, bisa melihat seperti berikut:

apikey.jpg

Atau dapat juga ditemukan pada kanan atas halaman profile Anda. Dengan demikian, kunci penghubung adalah:

b516176c4b0ceb0c

Kunci Salah

Apabila kunci yang dimasukkan salah, untuk semua data keluaran akan menampilkan pesan berbentuk teks (string)1):

Wrong API Key

Meskipun header respon akan memunculkan metadata valid request seperti cuplikan sekilas berikut:

Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Content-Encoding: gzip
Content-Length: 39
Content-Type: text/html

200 OK

Mengubah Kunci

API Key dibuat pada saat pendaftaran anggota baru. Sampai saat ini, hanya Administrator (Tim Elyez) yang dapat merubah kunci API Anda. Apabila Anda ingin merubah API Key, misalnya data yang tadinya bersifat sharing ingin diprivatisasi, mohon hubungi kami segera dengan menggunakan alamat email yang Anda gunakan.

1) Pesan teks/string ini dapat berubah sewaktu-waktu