Setup
บทความนี้จะแสดงวิธีการตั้งค่าอย่างรวดเร็วในฐานะนักพัฒนาและเริ่มทดสอบ API ของเราบน Wink
:::หมายเหตุ การทดสอบควรเกิดขึ้นเสมอในสภาพแวดล้อมการจัดฉากมีข้อมูลน้อยกว่ามาก แต่คุณสามารถทดสอบได้มากเท่าที่คุณต้องการ โดยไม่กระทบต่อสภาพแวดล้อมการผลิต
เมื่อคุณพร้อมที่จะเริ่มใช้งาน เราจะรับรองบัญชีและแอปพลิเคชันของคุณ และคุณสามารถเปิดตัวในสภาพแวดล้อมการผลิตของเราได้ :::
ปฏิบัติตามขั้นตอนเหล่านี้:
- ลงทะเบียน บัญชีผู้ใช้ของคุณบน Wink
- สร้าง บัญชีตัวแทนท่องเที่ยว หรือ บัญชีพันธมิตร-
- สร้างแอปพลิเคชัน ซึ่งคุณเชื่อมโยงกับบัญชีที่คุณสร้างในขั้นตอนที่ 2
- เมื่อคุณสร้างของคุณแล้ว
Application
บันทึกรหัสไคลเอนต์และความลับไคลเอนต์ไว้ในสถานที่ที่ปลอดภัย
ซีดีเอ็น
Section titled “ซีดีเอ็น”ที่ Wink เราใช้ Cloudinary สำหรับรูปภาพและวิดีโอทั้งหมดของเรา เมื่อคุณเข้าถึงสินค้าคงคลังการเดินทางของเรา คุณจะมีสิทธิ์เข้าถึงฟีเจอร์ขั้นสูงทั้งหมดของ Cloudinary
ของเรา cloud_name
เป็น traveliko
-
คลาวด์นารี
Section titled “คลาวด์นารี”ตัวอย่าง
Section titled “ตัวอย่าง”สำหรับประเภทสินค้าคงคลังการเดินทางทุกประเภทที่เรารองรับ จะมีอาร์เรย์ 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 เฉพาะของ Cloudinarypartners/radisson_blu_logo
นั่นคือทั้งหมดที่คุณต้องทำเพื่อรับรูปภาพในรูปแบบ คุณภาพ และขนาดที่คุณต้องการ
การทดสอบ
Section titled “การทดสอบ”มุ่งหน้าไปที่เราAPIsส่วนและเลือก API ที่คุณต้องการใช้งาน
เอกสาร API
Section titled “เอกสาร API”ไซต์เอกสารของเราได้รับการตั้งค่าเพื่อให้คุณสามารถรันคำสั่ง API จากภายในไซต์ได้
ในตัวอย่างนี้ คุณต้องการใช้Search Lookups (OAuth2)
การเรียก API
:::tip[เคล็ดลับสำหรับมืออาชีพ]
เพื่อความสะดวกในการใช้งาน เราขอแนะนำให้ผู้บูรณาการใช้จุดสิ้นสุดที่เรากำหนดเป็นOAuth2
จุดสิ้นสุดเหล่านั้นรู้ว่าจะต้องคาดหวังการเรียก API และรู้แล้วว่าคุณอยู่ในบัญชีใด ดังนั้นคุณจึงไม่จำเป็นต้องระบุcompanyIdentifier
ใน URL ของคุณ
:::
- ใช้ ค้นหา API เพื่อดึงข้อมูลจุดหมายปลายทางหรือโรงแรม
- ในแถบนำทางด้านซ้าย คลิกที่
Authentication
- - ป้อนรหัสลูกค้าและรหัสลับลูกค้าของคุณแล้วคลิก
Get TOKEN
ปุ่ม. - หากข้อมูลประจำตัวของคุณถูกต้อง คุณจะเห็นว่าคีย์ API ของคุณถูกนำไปใช้แล้ว
- ตอนนี้คุณสามารถทดสอบจุดสิ้นสุดการค้นหาได้แล้ว
พนักงานส่งจดหมาย
Section titled “พนักงานส่งจดหมาย”คุณสามารถทำสิ่งเดียวกันกับ Postman ได้
- ดาวน์โหลด พนักงานส่งจดหมาย-
- คลิ๊กที่นี่
Download OpenAPI spec
จากด้านบนของ ค้นหา API หน้าหนังสือ. - นำเข้าไปใน Postman
- หากคุณนำเข้ามาเป็นคอลเลกชั่นใหม่ที่เรียกว่า
Wink API
คลิกที่จุดไข่ปลาแนวนอน (จุด 3 จุด) ถัดจากชื่อคอลเลกชัน แล้วคลิกEdit
- - ใน
Authorization tab
, ตั้งค่า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 Secret
ไปยังความลับของไคลเอนต์ที่แอปของคุณช่วยสร้างขึ้น - ตั้งค่าฟิลด์
Scope
ถึงinventory.read inventory.write inventory.remove
เหล่านี้คือขอบเขตทั้งหมดที่คุณจะต้องการสำหรับ Wink - ตั้งค่าฟิลด์
Client Authentication
ถึงSend as Basic Auth header
- - คลิกที่
Get New Access Token
ปุ่มเพื่อรับโทเค็นของคุณและบันทึก - สำหรับการเรียก API ทั้งหมดภายใต้คอลเลกชัน API ของ Wink โปรดตรวจสอบให้แน่ใจว่าแท็บการตรวจสอบสิทธิ์ระบุว่า
Inherit auth from parent
ดังนั้นจึงรวมโทเค็นของคุณเข้ากับทุกการโทร
:::tip[เคล็ดลับสำหรับมืออาชีพ] ขอแนะนำให้สร้างโดเมนเซิร์ฟเวอร์ รหัสไคลเอนต์ และความลับของไคลเอนต์ลงในตัวแปรสภาพแวดล้อม วิธีนี้จะช่วยให้คุณสลับไปมาระหว่างสภาพแวดล้อมสเตจจิ้งและสภาพแวดล้อมการผลิตได้อย่างง่ายดาย และนำการดำเนินการทั้งหมดที่คุณสร้างขึ้นกลับมาใช้ใหม่ได้ :::