Syarat Penggunaan

Tentang layanan ini

API Samarinda adalah gerbang tunggal menuju data resmi perangkat daerah Pemerintah Kota Samarinda, dilayani dalam format JSON lewat arsitektur REST.

Data yang Anda terima berasal langsung dari server perangkat daerah pemiliknya. Portal ini meneruskan, tidak menyimpan salinannya sebagai sumber kebenaran — sehingga isi, ketepatan, dan kemutakhirannya adalah tanggung jawab perangkat daerah yang bersangkutan.

Akun dan token

Identitas berasal dari SSO Samarinda. Portal ini tidak menyimpan kata sandi Anda.

Token berlaku 24 jam dan hanya ditampilkan sekali saat diterbitkan. Portal menyimpan sidik jarinya, bukan tokennya — jadi token yang hilang tidak bisa ditampilkan kembali, hanya diganti dengan yang baru.

Token adalah tanggung jawab pemegangnya. Jangan menaruhnya di kode yang dibagikan, dan laporkan segera bila bocor agar bisa dicabut.

Batas pemakaian

Setiap token dibatasi 120 panggilan per menit. Melewatinya dijawab HTTP 429 dan panggilan berikutnya ditunda, bukan diblokir permanen.

Batas ini menjaga server perangkat daerah, bukan membatasi Anda. Bila aplikasi Anda memang butuh lebih, ajukan lewat Hubungi Kami dengan menyebutkan perkiraan bebannya.

Yang tidak diperbolehkan

Memakai data untuk menyesatkan, memalsukan dokumen, atau mengaku mewakili Pemerintah Kota Samarinda.

Membagikan token kepada pihak lain, atau memakai satu token untuk banyak aplikasi sehingga jejak pemakaiannya tak bisa ditelusuri.

Mengambil data secara beruntun di luar batas wajar sehingga mengganggu layanan perangkat daerah bagi pengguna lain.

Penangguhan

Akun yang melanggar dapat ditangguhkan. Penangguhan MENCABUT seluruh token akun itu seketika, sehingga aplikasi yang memakainya berhenti berfungsi saat itu juga.

Bila menurut Anda penangguhan itu keliru, hubungi Diskominfo — keputusannya dibuat manusia dan bisa ditinjau ulang.

Ketersediaan

Portal ini memeriksa kesehatan tiap endpoint secara berkala. Endpoint yang gagal disembunyikan dari katalog agar pengembang baru tidak diarahkan ke pintu yang sedang rusak — tetapi TETAP bisa dipanggil, supaya integrasi yang sudah berjalan tidak ikut putus.

Keadaan terkini seluruh endpoint terbuka untuk umum di halaman Status.