Nền tảng

Open Hotel Protocols

Lớp giao diện mở bên dưới Nerve — một bề mặt có tài liệu, scope theo từng thao tác, và một playground nơi cả yêu cầu lẫn phản hồi đều là thật.

Đăng ký danh sách chờ →Đọc tài liệu →

Đây là gì

Open Hotel Protocols là cam kết rằng mọi thao tác trong sản phẩm đều được mô tả, có scope và gọi được, chứ không phải một màn hình với nút xuất dữ liệu phía sau. Đây là trụ cột duy nhất trong ba trụ cột mà chủ đề không phải một màn hình — nên cách lập luận trung thực là bằng một yêu cầu thật, một phản hồi thật, và lời từ chối xuất hiện khi một khóa vươn quá scope của nó.

01

Một yêu cầu, một phản hồi, và một lời từ chối

Playground chạy các lệnh gọi thật trên trình duyệt bằng một khóa tạm ngắn hạn. Một lệnh trả về 200 kèm JSON thô. Một lệnh trả về 403 — vì khóa tạm không giữ scope mà endpoint đó yêu cầu, và endpoint nói rõ nó cần scope nào. Một giao diện mà bạn không bao giờ thấy nó từ chối bạn thì không phải giao diện đáng xây lên trên.

API Playground trong Nerve, chạy các lệnh gọi ngay trên trình duyệt. Một yêu cầu trả về 200 kèm JSON thô của danh sách đặt phòng; một yêu cầu khác, mà khóa tạm không có scope, trả về 403. Mỗi endpoint hiện scope nó cần và nút Run riêng.
Yêu cầu thật và phản hồi thật — kể cả cái bị từ chối.
02

Scope theo từng thao tác, không phải theo từng hệ thống

Một khóa chỉ giữ những scope có tên và không hơn, và chúng nhìn thấy được ngay trong danh sách mà không cần mở. Quyền được cấp ở mức thao tác — đọc một đặt phòng, ghi một khoản phí, hoàn một khoản thanh toán — nên một tích hợp có đúng mức đặc quyền mà công việc của nó cần.

Màn hình API Keys trong Nerve. Hai khóa được liệt kê kèm phần đầu bị cắt, nhãn “active”, ngày tạo và nút Revoke, với các scope đã cấp hiện ngay dưới mỗi tên dưới dạng thẻ mã.
Một khóa làm được gì thì nhìn thấy ngay mà không cần mở ra.
03

Xây một lần, dựa trên tài liệu đã công bố

Các khái niệm, tài liệu tham chiếu và hướng dẫn theo tác vụ đều nằm trên chính trang này — không nằm sau cổng đối tác và không nằm sau NDA. Đọc khái niệm để nắm mô hình, đọc tham chiếu để thấy bề mặt, và đọc hướng dẫn để có đúng trình tự bạn cần.

Điều đó có nghĩa gì với một tác nhân

Một client tuân thủ sẽ khám phá được nó gọi được gì, gọi nó, và nhận về một câu trả lời có cấu trúc hoặc một lời từ chối có cấu trúc. Đó là toàn bộ hợp đồng, và đó là điều cho phép đối tác xây một lần thay vì mỗi cơ sở một lần.

Tìm hiểu sâu hơn

Mọi màn hình phía trên đều có tài liệu, từng thao tác một, đối chiếu với sản phẩm đã phát hành.

Đăng ký danh sách chờ →Bắt đầu từ loại cơ sở của bạn →

Đang phân vân liệu nó có hợp với cơ sở quy mô của bạn?

← Tất cả tính năng