Fungsi token akses
Token akses (disebut juga API key) memungkinkan software Anda sendiri, developer, atau alat pihak ketiga membaca data dari toko Anda lewat API Storeep. Setiap token punya izin, rentang data, dan tanggal kedaluwarsa sendiri, jadi Anda bisa memberi setiap alat persis apa yang dibutuhkannya dan mencabutnya kapan saja tanpa membagikan kata sandi Anda.
Buka Pengaturan > Token akses. Tombol Lihat dokumentasi membuka referensi API, berisi endpoint, cara mengirim token, dan batas permintaan. Bagikan halaman itu kepada developer Anda.
Ingin menghubungkan asisten AI seperti Claude atau ChatGPT? Itu tidak memakai token akses. Lihat Menghubungkan asisten AI.
Membuat token
Klik Buat token baru, isi formulirnya, lalu klik Buat.
- Nama token: label untuk mengenalinya di daftar Anda, misalnya "Sinkronisasi akuntansi". Hanya Anda yang melihatnya.
- Izin akses: centang minimal satu:
- Baca produk: daftar produk, detail, varian, dan inventaris.
- Baca pesanan: riwayat pesanan, detail, status, dan item pesanan.
- Baca webhook: melihat konfigurasi webhook dan log pengirimannya.
- Kelola webhook: membuat, memperbarui, dan menghapus langganan webhook lewat API.
- Akses data: seberapa jauh ke belakang token bisa membaca data.
- 24 jam terakhir: hanya data yang dibuat dalam 24 jam terakhir. Opsi paling aman, cocok untuk sinkronisasi langsung.
- Atur tanggal mulai: hanya data yang dibuat pada atau setelah tanggal yang Anda pilih di Tanggal mulai akses data.
- Semua waktu: semua data Anda, tanpa batas tanggal.
- Masa berlaku: Tidak pernah kedaluwarsa, atau Atur tanggal kedaluwarsa untuk memilih tanggal hingga satu tahun ke depan. Setelah tanggal itu, token berhenti bekerja dengan sendirinya.
Salin token Anda sekarang
Setelah Anda klik Buat, jendela menampilkan Token akses Anda dengan tombol salin. Token ini hanya ditampilkan sekali. Salin dan simpan di tempat aman, seperti pengelola kata sandi. Storeep tidak bisa menampilkannya lagi. Jika hilang, hapus token itu dan buat yang baru.
Perlakukan token seperti kata sandi. Jangan pernah menaruhnya di kode situs web, repositori publik, tangkapan layar, atau pesan chat.
Daftar token
- Nama, beserta tanggal pembuatannya.
- Izin akses: misalnya Baca produk atau Baca pesanan.
- Akses data: 24 jam terakhir, Semua data, atau Dari suatu tanggal.
- Masa berlaku: sebuah tanggal, atau Tidak pernah.
- Terakhir digunakan: kapan terakhir kali sebuah alat memakai token, atau Tidak pernah.
Ada jumlah maksimum token per toko. Jika sudah tercapai, tombol Buat token baru hilang sampai Anda menghapus salah satunya.
Mengedit token
Klik sebuah token untuk mengubah nama, izin, akses data, atau masa berlakunya. Nilai token tetap sama, jadi alat yang memakainya tetap bekerja dengan aturan baru.
Menghapus token
Centang satu atau beberapa token lalu pilih Hapus token, atau gunakan tombol tempat sampah di sebuah baris. Token langsung berhenti bekerja, dan alat apa pun yang memakainya akan mendapat error.
Tips
- Beri setiap alat token sendiri, agar Anda bisa mencabut satu tanpa merusak yang lain.
- Pilih rentang data terkecil yang masih mencukupi.
- Atur tanggal kedaluwarsa untuk freelancer dan pekerjaan sekali jalan.
- Token yang lama menampilkan Tidak pernah di Terakhir digunakan kemungkinan besar tidak diperlukan. Hapus saja.
- Agar Storeep yang mengirim event pesanan ke server Anda, bukan server Anda yang meminta, gunakan webhook.