HUGEDATA

Cara mendapat akses

Halaman-halaman katalog ini terbuka untuk siapa saja. Angkanya tidak: untuk membaca satu pun baris atau satu pun nilai indikator, sebuah permintaan harus membawa kunci API yang sah dan hak akses atas dataset atau indikator yang diminta.

Tiga hal yang harus ada, dan semuanya diperiksa setiap permintaan

  1. Kunci API. Diterbitkan untuk satu konsumen, disimpan di sisi kami hanya sebagai hash (argon2id) sehingga tidak bisa dibaca kembali, punya daftar scope dan tanggal kedaluwarsa, dan bisa dicabut. Yang ditampilkan kembali hanya awalannya.
  2. Scope. Kemampuan yang boleh dibuka kunci itu — daftarnya di bawah. Scope dinamai menurut kemampuan, bukan menurut rute, karena rute boleh berpindah sedangkan yang Anda beli tidak.
  3. Hak akses (entitlement). Potongan yang lebih halus: per dataset atau per indikator, dengan masa berlaku sendiri. Scope records:read tanpa hak akses atas sebuah dataset tidak membuka dataset itu.

Setelah ketiganya lolos, kelas hak pakai dataset masih memutuskan bentuk keluaran yang diizinkan (baris, agregat, atau turunan), lalu ambang agregasi diterapkan, lalu pemakaiannya dicatat. Tidak ada satu pun dari langkah itu yang bisa dilewati dengan scope.

Arti setiap scope

ScopeYang dibuka
catalog:readKatalog: dataset apa yang tersedia untuk Anda, versi-versinya, angka mutunya, dan kamus datanya. Inilah versi berhak-akses dari halaman-halaman katalog ini.
records:readBaris terkurasi sebuah dataset. Tetap tunduk pada kelas hak pakai: dataset DERIVED_ONLY menolak permintaan baris walaupun scope ini ada di kunci Anda.
indicators:readNilai indikator per wilayah dan per periode, masing-masing dengan basis dan asal-usulnya.
geo:readHierarki wilayah, daerah pemilihan 2024, dan agregat geografis yang dibangun di atasnya.
changefeed:readDaftar versi yang terbit sejak kursor tertentu, supaya aplikasi Anda tahu kapan harus mengambil ulang.
usage:readPemakaian Anda sendiri: rute, dataset, jumlah baris dan durasi, sebagai dasar tagihan.

Alamat API

Seluruh endpoint berada di bawah https://api.diaas.smartchaincode.com/api/v1, lewat HTTPS, dengan kunci dikirim di header permintaan.

GET https://api.diaas.smartchaincode.com/api/v1/catalog/datasets

Setiap respons yang mengandung angka membawa meta.provenance (dataset, versi, waktu terbit, sumber dengan lisensi dan kelas haknya, periode data), meta.quality, dan meta.thresholds. Itu bagian dari kontraknya, bukan tambahan.

Meminta akses

Kunci dan hak akses diterbitkan satu per satu oleh operator layanan ini; belum ada pendaftaran swalayan, dan harga langganan belum ditetapkan. Sebutkan dataset atau indikator yang Anda perlukan — daftarnya ada di halaman dataset dan indikator — beserta untuk apa angkanya dipakai, karena sebagian sumber kami membatasi penggunaan turunannya lewat lisensinya sendiri.

Konsumen internal NXANTARA tercatat pemakaiannya tetapi tidak ditagih. Angka langganan untuk pelanggan luar belum ada dan belum tervalidasi; siapa pun yang menyebut angka harga sebagai sesuatu yang sudah tetap, menyebutnya tanpa dasar.

Cara mendapat akses · HUGEDATA