Aplikasi
Aplikasi memberi anda akses kepada semua ciri Wink sebagai pembangun. Anda boleh mengakses semua data yang sama dan malah mengembangkan ciri Wink sendiri. Anda boleh memilih untuk menggunakan pelayan OAuth2 Wink untuk mengesahkan laman perjalanan anda sama seperti anda menggunakan Google atau Facebook. Dengan cara itu anda boleh mengembangkan ciri Wink ke dalam laman web atau aplikasi anda sendiri.
- Pilih akaun yang anda ingin urus dari Accounts.
- Klik pada
Actionsdi bahagian bawah kad akaun dan pilihManage account. - Klik tab
Applicationspada halaman berikutnya. - Bahagian ini akan menyenaraikan semua aplikasi anda.
- Putar atau padam aplikasi sedia ada, atau cipta yang baru.
Cipta aplikasi
Section titled “Cipta aplikasi”Oleh kerana anda tidak boleh mengakses secret key aplikasi yang kami cipta untuk anda, anda perlu mencipta sendiri.
Anda boleh mencipta aplikasi di sini tanpa perlu menyediakan hartanah atau syarikat terlebih dahulu — ia tidak terikat
kepada mana-mana akaun tertentu.
Jenis klien
Section titled “Jenis klien”Apabila mencipta aplikasi, anda memilih jenis klien yang menentukan bagaimana aplikasi mengesahkan. Ini tidak boleh diubah kemudian — jika anda memerlukan jenis yang berbeza, cipta aplikasi baru.
- Aplikasi web — Aplikasi yang dirender di pelayan yang boleh menyimpan rahsia klien dengan selamat (aliran kod kebenaran).
- Aplikasi satu halaman (SPA) — Aplikasi pelayar tanpa backend; menggunakan PKCE, tanpa rahsia klien.
- Aplikasi mudah alih — Aplikasi asli iOS/Android; menggunakan PKCE dengan token segar semula yang berputar.
- Mesin-ke-mesin — Perkhidmatan backend yang bertindak sebagai dirinya sendiri (kelayakan klien); tiada log masuk pengguna.
Berikut adalah langkah-langkah untuk mencipta aplikasi:
- Dari halaman aplikasi, klik butang
Create new application. - Nama Berikan nama kepada aplikasi anda. contoh: Cool App
- Jenis klien Pilih jenis yang sesuai dengan cara aplikasi anda mengesahkan — lihat Jenis klien di atas.
- Redirect URIs Sekurang-kurangnya satu redirect URI diperlukan. Ia digunakan untuk mengesahkan domain redirect selepas pengesahan berjaya. Tidak digunakan untuk aplikasi Mesin-ke-mesin. contoh: https://www.cool-site.com
- Post-logout redirect URIs (Pilihan) URL di mana pengguna boleh diarahkan selepas log keluar. Biarkan kosong untuk menggunakan semula redirect URI di atas.
- Skop Pilih apa yang aplikasi ini boleh akses bagi pihak anda — lihat Memilih skop di bawah.
- Klik butang
Create applicationuntuk meneruskan.
Anda akan diarahkan kembali ke senarai aplikasi anda, dan dialog sekali sahaja akan memaparkan Client ID dan Client secret baru. Salin rahsia tersebut sekarang dan simpan di tempat selamat — ia tidak akan dipaparkan lagi, dan tiada cara untuk mendapatkannya semula kemudian (hanya boleh putar untuk yang baru).
Memilih skop
Section titled “Memilih skop”Setiap aplikasi sentiasa membawa skop Sign-in (OpenID Connect) (openid, profile,
email, offline_access) — ini mengesahkan identiti pengguna dan memastikan mereka kekal log masuk, jadi ia
ditandakan dan dikunci; ia bukan pilihan.
Semua yang lain adalah pilihan. Skop yang tinggal dikelompokkan mengikut bahagian fungsi yang sama
yang didokumenkan dalam Skop — Akaun, Inventori & kadar, Tempahan,
Pemasaran & promosi, Kandungan hartanah, Analitik & laporan, Integrasi pengurus saluran,
Pembayaran, dan Perakaunan & lejar — setiap satu dengan penerangan mudah tentang apa yang dibuka. Gunakan
pautan All / None di atas senarai untuk memilih atau membersihkan semua skop pilihan sekaligus.
Dua keluarga skop sengaja tidak ditawarkan dalam borang ini:
mcp.*— akses ejen AI kepada Model Context Protocol transport. Anda tidak mencipta aplikasi untuknya: klien AI seperti Claude, ChatGPT atau Codex mendaftar sendiri dan meminta skop ini apabila anda log masuk melalui skrin persetujuan MCP. Ia tidak pernah diberikan kepada aplikasi mesin-ke-mesin, kerana MCP sentiasa bertindak bagi pihak pengguna yang log masuk.- Skop tahap pentadbir (
administrator.*) — akses tahap platform yang tidak diberikan per aplikasi.
Setelah aplikasi dicipta, tab ini dan juga Consented Apps memaparkan skop yang diberikan
mengikut bahagian (contoh: “Tempahan: booking.read”), supaya anda boleh melihat apa yang aplikasi boleh lakukan dengan cepat
tanpa perlu membukanya.
Putar kelayakan
Section titled “Putar kelayakan”Jika rahsia klien mungkin telah bocor, atau anda hanya mahu kelayakan baru, putar ia daripada mencipta semula aplikasi:
- Cari aplikasi dalam senarai aplikasi anda dan klik
Rotate. - Sahkan dialog — Client ID dan rahsia semasa akan berhenti berfungsi serta-merta.
- Salin Client ID dan rahsia baru dari dialog sekali sahaja sebelum menutupnya.
Memutar mengekalkan nama aplikasi, jenis klien, redirect URI, dan skop — hanya kelayakan yang berubah.
Buang aplikasi
Section titled “Buang aplikasi”Jika anda tidak lagi memerlukan aplikasi, anda boleh terus membuangnya. Ini adalah kekal — kelayakan akan dibatalkan serta-merta dan tidak boleh dipulihkan.
- Cari aplikasi dalam senarai aplikasi anda dan klik
Delete. - Sahkan dialog untuk memadam aplikasi secara kekal.
