Thông tin chung

Mô-đun cuối cùng đã kết thúc với việc tạo ra quy trình kinh doanh đầu tiên. Chúng tôi đã tìm ra cách tạo logic quy trình, chấp nhận các tham số đầu vào cụ thể, thực hiện các phép tính và đưa ra câu trả lời. Nó vẫn còn để trả lời câu hỏi chính. Làm thế nào để kích hoạt quy trình nghiệp vụ đã tạo và đưa nó vào hoạt động?

Để giải quyết vấn đề này, các điểm cuối được dự định - các điểm tương tác chính với ứng dụng. Trong các mô-đun đầu tiên, chúng tôi đã tương tác với các API bên ngoài. Điều này có thể thực hiện được nhờ sự hiện diện của các điểm cuối. Chúng đã được mô tả trong tài liệu và chúng tôi đã đọc nó và hiểu phương pháp nào và URL nào cần thiết để gửi yêu cầu truy cập một tài nguyên cụ thể.

Để hiểu rõ, hãy xem việc triển khai các điểm cuối bằng một ví dụ cụ thể. Trong mô-đun thứ ba, mô hình cơ sở dữ liệu đã được tạo. Đồng thời, đồng thời với việc tạo bảng, các điểm cuối được tạo tự động để tương tác với chúng. Hãy chuyển đến phần điểm cuối (trên bảng điều khiển bên trái) và xem xét chúng.

Trong ví dụ về bảng " city " với thông tin về các thành phố, có thể thấy rằng nó đã có sẵn 6 điểm cuối cho các thao tác dữ liệu cơ bản.

• GET /city - lấy tất cả dữ liệu từ một bảng
• GET /city/:id - lấy dữ liệu về thành phố với id được chỉ định
• POST /city - thêm bản ghi mới vào bảng
• PUT /city/:id - thay thế hoàn toàn bản ghi bằng id được chỉ định trong bảng
• PATCH /city/:id - thay thế một phần bản ghi bằng id được chỉ định trong bảng
• DELETE /city/:id - xóa bản ghi có id đã chỉ định khỏi bảng

Cài đặt chung

Bạn có thể mở cài đặt cho từng điểm cuối và nghiên cứu chi tiết hơn. Ví dụ, xét điểm cuối GET /city/:id

Hình ảnh chúng ta thấy rất giống với những gì chúng ta đã thấy khi tạo yêu cầu cho các API bên ngoài. Trong một trường hợp, chúng tôi chỉ truy cập một điểm cuối được tạo sẵn và bây giờ chúng tôi đang tự tạo và định cấu hình điểm cuối này. Để cấu hình, bạn phải chỉ định:

1. Phương pháp yêu cầu . Trong ví dụ này, đây là phương thức GET .
2. Yêu cầu URL . Phần đầu tiên với đường dẫn đến máy chủ không được chỉ định. Nó giống nhau cho tất cả các điểm cuối của ứng dụng. Chỉ cần xác định kết thúc ( /city ) là đủ. Tham số URL cũng được chỉ định ở đây. Điểm cuối được thiết kế để nhận thông tin về một thành phố cụ thể, do đó, id của nó được viết sau “:” được chuyển dưới dạng tham số.
3. Endpoint Groups . Tham số này không ảnh hưởng đến hoạt động của điểm cuối theo bất kỳ cách nào và chỉ nhằm mục đích thuận tiện cho tổ chức. Tất cả các điểm cuối có thể được chia thành các nhóm (thư mục) theo chủ đề. Trong ví dụ này, nhóm " city " chứa tất cả các điểm cuối để làm việc với dữ liệu về các thành phố.
4. Business Process . Đây là mục cấu hình quan trọng nhất và là thứ không thể nhìn thấy theo bất kỳ cách nào khi gửi yêu cầu đến điểm cuối. Dấu hiệu của quy trình kinh doanh xác định điểm cuối này sẽ làm gì. Đồng thời, bản thân điểm cuối có thể không thay đổi, nó sẽ nhận tất cả các yêu cầu giống nhau tại địa chỉ cũ, đồng thời, nếu quy trình nghiệp vụ được thay thế, nó sẽ thực hiện một chức năng hoàn toàn khác. Quy trình kinh doanh cho các hoạt động cơ sở dữ liệu cơ bản được tạo tự động. Chúng được gọi là quy trình nghiệp vụ hệ thống. Không thể thay đổi các BP như vậy nhưng có thể thay thế bất kỳ lúc nào bằng các BP được tạo độc lập, với các quy trình kinh doanh tùy chỉnh.
5. Input/Output variables . Quy trình kinh doanh đã tạo sử dụng nhiều biến đầu vào và đầu ra khác nhau, nhưng điểm cuối không phải sử dụng tất cả chúng. Có thể tắt hoặc định cấu hình một phần để các điểm cuối khác nhau truy cập cùng một BP, với một bộ biến riêng lẻ. Loại yêu cầu và phản hồi ( Request / Response type ) cũng được cấu hình ở đó. Thông thường, loại này sẽ là JSON, nhưng nếu cần, có thể sử dụng các tùy chọn khác, chẳng hạn như XML hoặc Render File kết xuất (loại phản hồi này được sử dụng trong các điểm cuối để làm việc với tệp).

Cài đặt phần mềm trung gian

Cài đặt chung là đủ để tạo và sử dụng thêm điểm cuối, nhưng có thể sử dụng các tham số bổ sung nếu cần. Điều quan trọng nhất trong số này là kích hoạt Middleware bằng mã thông báo Auth .

Việc sử dụng nó cho phép bạn từ chối quyền truy cập vào điểm cuối này đối với những người dùng chưa được ủy quyền hoặc không thuộc một nhóm nhất định (ví dụ: quyền truy cập chỉ có thể được cấp cho quản trị viên và bị từ chối đối với những người dùng khác).

Cài đặt ghi nhật ký và đầu ra

Ngoài ra, bạn có thể sử dụng các cài đặt trên tab Settings để ghi thêm tiêu đề hoặc nội dung yêu cầu, cũng như để ẩn phản hồi những trường có giá trị không được đặt.