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

การตั้งค่า

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

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

  1. ลงทะเบียน บัญชีผู้ใช้ของคุณบน Wink
  2. สร้างบัญชีพันธมิตร คุณจะต้องใช้บัญชีนี้เพื่อผูกกับแอปพลิเคชันของคุณ ดู Studio คืออะไร เพื่อบริบทเพิ่มเติม
  3. สร้างแอปพลิเคชัน และเชื่อมโยงกับบัญชีพันธมิตรที่คุณสร้างในขั้นตอนที่ 2 สำหรับการรวม API แบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ ให้เลือก 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 เพื่อให้รวมโทเค็นของคุณในทุกคำเรียก