การตั้งค่า

บทความนี้แสดงวิธีการตั้งค่าอย่างรวดเร็วในฐานะนักพัฒนาและเริ่มทดสอบ API ของเราใน Wink

ทำตามขั้นตอนเหล่านี้:

ลงทะเบียน บัญชีผู้ใช้ของคุณบน Wink
สร้างบัญชีพันธมิตร คุณจะต้องใช้บัญชีนี้เพื่อผูกกับแอปพลิเคชันของคุณ ดู Studio คืออะไร เพื่อข้อมูลเพิ่มเติม
สร้างแอปพลิเคชัน และเชื่อมโยงกับบัญชีพันธมิตรที่คุณสร้างในขั้นตอนที่ 2 สำหรับการเชื่อมต่อ API แบบ server-to-server ให้เลือก MACHINE_2_MACHINE เป็นประเภทไคลเอนต์
เมื่อคุณสร้าง Application แล้ว ให้คัดลอกและบันทึก client-id และ secret key ทันที — secret key จะแสดงเพียงครั้งเดียวและไม่สามารถเรียกคืนได้อีก

CDN

ที่ Wink เราใช้ Cloudinary สำหรับภาพและวิดีโอทั้งหมดของเรา เมื่อคุณเข้าถึงสินค้าคงคลังการเดินทางของเรา คุณจะสามารถใช้ฟีเจอร์ขั้นสูงทั้งหมดของ Cloudinary ได้อย่างเต็มที่

cloud_name ของเราคือ traveliko

Cloudinary

ตัวอย่าง

สำหรับสินค้าคงคลังการเดินทางทุกประเภทที่เรารองรับ จะมีอาร์เรย์ JSON ซ้อนชื่อ multimedias JSON สำหรับรายการมัลติมีเดียมีลักษณะดังนี้:

{
  "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"
    }
  ]
}

บรรทัดที่เน้นด้านบนแสดง ID เฉพาะของ Cloudinary คือ partners/radisson_blu_logo นั่นคือข้อมูลที่คุณต้องใช้เพื่อดึงภาพในรูปแบบ คุณภาพ และขนาดใดก็ได้ที่คุณต้องการ

การทดสอบ

ไปที่ส่วน APIs ของเราและเลือก API ที่คุณต้องการใช้งาน

เอกสาร API

เว็บไซต์เอกสารของเราถูกตั้งค่าให้คุณสามารถรันคำสั่ง API ได้จากภายในเว็บไซต์

ในตัวอย่างนี้ คุณต้องการใช้คำสั่ง Search Lookups (OAuth2)

ใช้ Lookup API เพื่อดึงข้อมูลปลายทางหรือโรงแรม
ในแถบนำทางด้านซ้าย คลิกที่ Authentication
กรอก client-id และ client secret ของคุณแล้วคลิกปุ่ม Get TOKEN
หากข้อมูลรับรองของคุณถูกต้อง คุณจะเห็นว่า API key ของคุณถูกนำไปใช้แล้ว
ตอนนี้คุณสามารถทดสอบ endpoint lookup ได้

Lookup API endpoint — *ตัวอย่าง Search Lookups (OAuth2)*

Postman

คุณสามารถทำสิ่งเดียวกันนี้ด้วย Postman

ดาวน์โหลด Postman
คลิกที่ Download OpenAPI spec จากด้านบนของหน้า Lookup API
นำเข้าไฟล์นี้เข้าสู่ Postman
หากคุณนำเข้าเป็นคอลเลกชันใหม่ชื่อ Wink API ให้คลิกที่จุดสามจุดแนวนอนถัดจากชื่อคอลเลกชันแล้วคลิก Edit
ในแท็บ Authorization ตั้งค่า Auth type เป็น OAuth2
ตั้งค่า Add auth data to เป็น Request headers
ตั้งค่า Header prefix เป็น Bearer
ตั้งค่า Token Name เป็นชื่อที่คุณต้องการตั้งให้กับโทเค็นที่บันทึกใน Postman เช่น Wink Staging
ตั้งค่า Grant type เป็น Client Credentials
ตั้งค่า Access token URL เป็น https://staging-iam.wink.travel/oauth2/token
ตั้งค่า Client ID เป็น Client ID ที่แอปของคุณช่วยสร้าง
ตั้งค่า Client Secret เป็น Client Secret ที่แอปของคุณช่วยสร้าง
ตั้งค่า Scope เป็นสโคปที่การรวมระบบของคุณต้องการโดยเว้นวรรคระหว่างแต่ละสโคป (เช่น inventory.read inventory.write inventory.remove) ดู รายการสโคป สำหรับรายการเต็ม
ตั้งค่า Client Authentication เป็น Send as Basic Auth header
คลิกปุ่ม Get New Access Token เพื่อดึงโทเค็นและบันทึกมัน
สำหรับคำสั่ง API ทั้งหมดในคอลเลกชัน Wink API ให้แน่ใจว่าแท็บการรับรองความถูกต้องระบุว่า Inherit auth from parent เพื่อให้โทเค็นของคุณถูกแนบไปกับทุกคำสั่ง