Setup
Artikel ini menunjukkan kepada anda cara untuk menyediakan dengan cepat sebagai pembangun dan mula menguji API kami pada Wink.
Ujian hendaklah sentiasa berlaku dalam diri kita persekitaran pementasan. Terdapat lebih sedikit data di sana tetapi anda bebas untuk menguji seberapa banyak yang anda mahu tanpa mengenakan persekitaran pengeluaran.
Setelah anda bersedia untuk disiarkan secara langsung, kami akan memperakui akaun anda dan aplikasi anda dan anda boleh melancarkan dalam persekitaran pengeluaran kami.
Ikuti langkah ini:
- Daftar akaun pengguna anda di Wink
- Buat a akaun ejen pelancongan atau an akaun gabungan.
- Buat Aplikasi di mana anda mengaitkannya dengan akaun yang anda buat dalam Langkah 2.
- Sebaik sahaja anda telah mencipta anda
Application
, simpan klien-id dan rahsia pelanggan di tempat yang selamat.
Di Wink, kami menggunakan Cloudinary untuk semua aset imej dan video kami. Apabila anda mengakses inventori perjalanan kami, anda akan mempunyai akses penuh kepada semua ciri lanjutan Cloudinary.
kami cloud_name
ialah traveliko
.
Berawan
Section titled “Berawan”Contoh
Section titled “Contoh”Untuk setiap jenis inventori perjalanan yang kami sokong, akan terdapat tatasusunan JSON bersarang dipanggil multimedias
. JSON untuk entri multimedia kelihatan seperti ini:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Picture of the lobby", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}
Baris yang diserlahkan di atas menunjukkan ID unik Cloudinary partners/radisson_blu_logo
. Itu sahaja yang anda perlukan untuk mendapatkan semula imej dalam sebarang format, kualiti dan saiz yang anda mahukan.
Menguji
Section titled “Menguji”Pergi ke kami API bahagian dan pilih API yang anda mahu gunakan.
dokumen API
Section titled “dokumen API”Tapak dokumentasi kami disediakan dengan cara yang anda boleh menjalankan arahan API dari dalam tapak.
Dalam contoh ini, anda mahu menggunakan Search Lookups (OAuth2)
Panggilan API.
:::tip[Petua Pro]
Untuk kemudahan penggunaan, kami mengesyorkan agar penyepadu menggunakan titik akhir yang kami tetapkan sebagai OAuth2
. Titik akhir tersebut tahu menjangkakan pemanggil API dan sudah mengetahui akaun yang anda gunakan supaya anda tidak perlu menentukan companyIdentifier
dalam URL anda.
:::
- Gunakan API Carian untuk mendapatkan semula destinasi atau hotel.
- Dalam bar navigasi kiri, klik pada
Authentication
. - Masukkan id pelanggan dan rahsia pelanggan anda dan klik butang
Get TOKEN
butang. - Jika bukti kelayakan anda sah, anda akan melihat bahawa kunci API anda telah digunakan.
- Anda kini boleh menguji titik akhir carian.
Posmen
Section titled “Posmen”Anda boleh melakukan perkara yang sama dengan Posmen.
- Muat turun Posmen.
- klik pada
Download OpenAPI spec
dari atas API Carian muka surat. - Import ia ke dalam Posmen.
- Jika anda mengimportnya sebagai koleksi baharu dipanggil
Wink API
, klik pada elipsis mendatar (3 titik) di sebelah nama koleksi dan klikEdit
. - Dalam
Authorization tab
, tetapkanAuth type
kepada OAuth2. - Tetapkan medan
Add auth data to
kepadaRequest headers
. - Tetapkan medan
Header prefix
kepadaBearer
. - Tetapkan medan
Token Name
kepada apa sahaja yang anda mahu namakan token anda yang disimpan dalam Posmen. Cth. Pementasan Kejap. - Tetapkan medan
Grant type
kepadaClient Credentials
. - Tetapkan medan
Access token URL
ke https://staging-iam.wink.travel/oauth2/token. - Tetapkan medan
Client ID
kepada ID Pelanggan yang dijana oleh apl anda. - Tetapkan medan
Client Secret
kepada Rahsia Pelanggan yang dijana oleh apl anda. - Tetapkan medan
Scope
kepadainventory.read inventory.write inventory.remove
. Itu semua skop yang anda perlukan untuk Wink. - Tetapkan medan
Client Authentication
kepadaSend as Basic Auth header
. - Klik pada
Get New Access Token
butang untuk mendapatkan semula token anda dan menyimpannya. - Untuk semua panggilan API di bawah koleksi Wink API, pastikan tab pengesahan tertera
Inherit auth from parent
jadi ia termasuk token anda dengan setiap panggilan.
:::tip[Petua Pro] Adalah disyorkan untuk menjadikan domain pelayan, ID pelanggan dan pelanggan rahsia menjadi pembolehubah persekitaran. Dengan cara itu anda boleh menukar antara persekitaran pementasan dan pengeluaran dengan mudah dan menggunakan semula semua operasi yang telah anda buat. :::