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 gunakan dari Accounts.
Klik pada Actions di bahagian bawah kad akaun dan pilih Manage account.
Klik tab Applications pada halaman berikutnya.
Bahagian ini akan menyenaraikan semua aplikasi anda.
Putar atau padam aplikasi sedia ada, atau buat yang baru.

Buat aplikasi

Oleh kerana anda tidak boleh mengakses secret key aplikasi yang kami buat untuk anda, anda perlu membuat aplikasi anda sendiri. Anda boleh membuat aplikasi di sini tanpa perlu menyediakan hartanah atau syarikat terlebih dahulu — ia tidak terikat kepada mana-mana akaun tertentu.

Jenis klien

Apabila membuat aplikasi, anda memilih jenis klien yang menentukan bagaimana aplikasi mengesahkan. Ini tidak boleh diubah kemudian — jika anda memerlukan jenis yang berbeza, buat 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 yang berputar.
Mesin-ke-mesin — Perkhidmatan backend yang bertindak sebagai dirinya sendiri (kelayakan klien); tiada log masuk pengguna.

Berikut adalah langkah-langkah untuk membuat aplikasi:

Dari halaman aplikasi, klik butang Create new application.
Nama Beri nama 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 URIs di atas.
Skop Pilih apa yang aplikasi ini boleh akses bagi pihak anda — lihat Memilih skop di bawah.
Klik butang Create application untuk meneruskan.

Anda akan diarahkan kembali ke senarai aplikasi anda, dan dialog sekali sahaja akan memaparkan Client ID dan Client secret baru. Salin rahsia itu 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

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 ke dalam 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 ke Model Context Protocol yang disediakan secara berasingan dan hanya untuk klien mesin-ke-mesin.
Skop tahap pentadbir (administrator.*) — akses tahap platform yang tidak diberikan per aplikasi.

Setelah aplikasi dibuat, tab ini dan juga Consented Apps memaparkan skop yang diberikan dikelompokkan mengikut bahagian (contoh “Tempahan: booking.read”), supaya anda boleh lihat apa yang aplikasi boleh lakukan dengan cepat tanpa perlu membukanya.

Putar kelayakan

Jika rahsia klien mungkin telah bocor, atau anda hanya mahu kelayakan baru, putar ia daripada membuat 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 URIs, dan skop — hanya kelayakan yang berubah.

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.