แพลตฟอร์ม

Open Hotel Protocols

ชั้นอินเทอร์เฟซแบบเปิดใต้ Nerve — พื้นผิวที่มีเอกสารกำกับ scope ต่อหนึ่งคำสั่ง และ playground ที่ทั้งคำขอและคำตอบเป็นของจริง

ลงชื่อรอใช้งาน →อ่านเอกสาร →

นี่คืออะไร

Open Hotel Protocols คือคำมั่นว่าทุกคำสั่งในผลิตภัณฑ์นี้ถูกอธิบาย มี scope และเรียกใช้ได้ ไม่ใช่หน้าจอที่มีปุ่มส่งออกอยู่ข้างหลัง นี่เป็นเสาหลักเดียวในสามเสาที่หัวข้อของมันไม่ใช่หน้าจอ — วิธีอธิบายที่ซื่อตรงจึงต้องใช้คำขอจริง คำตอบจริง และการปฏิเสธที่เกิดขึ้นเมื่อคีย์เอื้อมเกิน scope ของตน

01

คำขอ คำตอบ และการปฏิเสธ

Playground เรียก API จริงในเบราว์เซอร์ด้วยคีย์ชั่วคราวอายุสั้น คำขอหนึ่งคืน 200 พร้อม JSON ดิบ อีกคำขอคืน 403 — เพราะคีย์ชั่วคราวไม่มี scope ที่ endpoint นั้นต้องการ และ endpoint ระบุว่าต้องการ scope ใด อินเทอร์เฟซที่คุณไม่มีทางเห็นมันปฏิเสธคุณ ไม่ใช่อินเทอร์เฟซที่สร้างต่อยอดได้

API Playground ใน Nerve เรียก API จริงในเบราว์เซอร์ คำขอหนึ่งคืนค่า 200 พร้อม JSON ดิบของรายการการจอง อีกคำขอหนึ่งซึ่งคีย์ชั่วคราวไม่มี scope คืนค่า 403 แต่ละ endpoint แสดง scope ที่ต้องใช้และปุ่ม Run ของตัวเอง
คำขอจริงและคำตอบจริง — รวมถึงคำขอที่ถูกปฏิเสธ
02

scope ต่อหนึ่งคำสั่ง ไม่ใช่ต่อหนึ่งระบบ

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

หน้าจอ API Keys ใน Nerve มีสองคีย์แสดงพร้อมส่วนต้นที่ถูกตัด ป้าย “active” วันที่สร้าง และปุ่ม Revoke โดยแสดง scope ที่ให้ไว้ใต้ชื่อแต่ละคีย์เป็นแท็กโค้ด
สิ่งที่คีย์ทำได้มองเห็นได้โดยไม่ต้องเปิดดู
03

สร้างครั้งเดียว บนเอกสารที่เผยแพร่จริง

แนวคิด เอกสารอ้างอิง และคู่มือแบบเป็นงาน ทั้งหมดอยู่บนเว็บไซต์นี้ — ไม่ได้อยู่หลังพอร์ทัลพันธมิตรและไม่ได้อยู่หลัง NDA อ่านแนวคิดเพื่อเข้าใจโมเดล อ่านเอกสารอ้างอิงเพื่อเห็นพื้นผิว และอ่านคู่มือเพื่อได้ลำดับที่คุณต้องการจริง

มันหมายถึงอะไรสำหรับเอเจนต์

ไคลเอนต์ที่ทำตามมาตรฐานจะค้นพบว่าตนเรียกอะไรได้ เรียกมัน แล้วได้คำตอบที่มีโครงสร้างหรือคำปฏิเสธที่มีโครงสร้าง นั่นคือสัญญาทั้งหมด และนั่นคือสิ่งที่ทำให้พันธมิตรสร้างครั้งเดียว ไม่ใช่ครั้งหนึ่งต่อหนึ่งโรงแรม

เจาะลึกกว่านี้

ทุกหน้าจอด้านบนมีเอกสารกำกับ คำสั่งต่อคำสั่ง อ้างอิงกับผลิตภัณฑ์ที่ปล่อยใช้จริง

ลงชื่อรอใช้งาน →เริ่มจากประเภทที่พักของคุณ →

สงสัยว่าเหมาะกับที่พักขนาดของคุณหรือไม่?

← ฟีเจอร์ทั้งหมด