ข้ามไปยังเนื้อหา
Wink

การตั้งค่า

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

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

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

CDN

หัวข้อที่มีชื่อว่า “CDN”

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

cloud_name ของเราคือ traveliko

Cloudinary

หัวข้อที่มีชื่อว่า “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”

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

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

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

Postman

หัวข้อที่มีชื่อว่า “Postman”

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

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