Điểm cuối là một phần thiết yếu của quy trình kinh doanh và phát triển ứng dụng nói chung. Trong bài viết này, chúng tôi xác định điểm cuối là gì, tại sao chúng tôi cần chúng và cách tạo chúng trên nền tảng AppMaster.io.
Điểm cuối là gì?
Điểm cuối là một cổng kết nối các quy trình máy chủ của ứng dụng với giao diện bên ngoài. Nói cách khác, đây là địa chỉ mà các yêu cầu được gửi đến.
Điều quan trọng là phải đề cập đến cách hoạt động của API để hiểu điểm cuối là gì. API là tên viết tắt của một giao diện lập trình ứng dụng. Các ứng dụng sử dụng API để tương tác với các dịch vụ của bên thứ ba và người dùng của họ.
Để kết nối với API, bạn cần gửi một yêu cầu. Để xử lý chính xác yêu cầu, máy khách phải cung cấp một con trỏ tài nguyên chung (URL), một phương thức HTTP và, tùy thuộc vào phương pháp, thêm tiêu đề, nội dung và các tham số yêu cầu. Phần đầu cung cấp siêu dữ liệu về yêu cầu, trong khi phần thân chứa dữ liệu, chẳng hạn như các trường cho các hàng mới trong cơ sở dữ liệu.
API sẽ xử lý yêu cầu và gửi phản hồi nhận được từ máy chủ. Phản hồi sẽ chứa mã trạng thái, là một phần của thông báo phản hồi HTTP thông báo cho khách hàng về kết quả yêu cầu. Ví dụ: mã 200 được sử dụng nếu thao tác hoàn tất thành công, mã 500 nếu xảy ra lỗi máy chủ nội bộ.
Các điểm cuối hoạt động cùng với các phương thức API. Đây là các URL cụ thể mà ứng dụng sử dụng để giao tiếp với các dịch vụ của bên thứ ba và người dùng của nó. URL là một tuyến có thể xử lý các phương thức yêu cầu khác nhau. Mỗi loại yêu cầu là một điểm cuối riêng biệt. Có năm loại chính:
- GET - lấy thông tin từ máy chủ; nó không yêu cầu một cơ quan yêu cầu;
- POST - tạo một đối tượng mới trong cơ sở dữ liệu, yêu cầu một phần thân yêu cầu với các trường của đối tượng này;
- PUT - đặt lại hoàn toàn một đối tượng cụ thể trong cơ sở dữ liệu;
- PATCH - tương tự như PUT, đặt lại một đối tượng cụ thể trong cơ sở dữ liệu, nhưng nó sẽ chỉ cập nhật các trường được đề cập trong phần thân yêu cầu;
- DELETE - xóa đối tượng khỏi cơ sở dữ liệu.
Khi tạo một yêu cầu cụ thể, nhiều thông số khác nhau có thể được thêm vào nó. Sự kết hợp của các tham số này và URL đại diện cho URI - Định danh tài nguyên đồng nhất. Nó chỉ ra nơi và cách tìm tài nguyên.
Bạn có thể định cấu hình điểm cuối trên nền tảng AppMaster.io như thế nào?
Trong phần Điểm cuối của nền tảng AppMaster.io, bạn có thể xem tất cả các điểm cuối được tạo tự động và điểm cuối của dự án của bạn. Nếu màn hình và trang tự động tạo trong dự án của bạn được bật, sẽ tự động tạo các điểm cuối tương ứng cho bất kỳ mô hình dữ liệu đã tạo nào. Ngoài ra, điểm cuối có thể được tạo tự động khi cài đặt một số mô-đun, ví dụ: Ủy quyền (Auth), Quốc gia và thành phố, v.v.
AppMaster.io cho phép bạn làm việc với một số loại API điểm cuối:
- API để truy cập phần phụ trợ từ máy khách và hệ thống của bên thứ ba;
- webhooks để nhận thông báo từ hệ thống của bên thứ ba;
- WebSockets, để mở phiên giao tiếp tương tác hai chiều giữa trình duyệt và máy chủ mà không yêu cầu máy chủ phản hồi.
Tất cả các điểm cuối được nhóm lại. Trong mỗi nhóm, bạn sẽ tìm thấy tất cả các điểm cuối tương ứng, các loại yêu cầu, URL và quy trình kinh doanh mà chúng được kết nối với. Bạn có thể xóa và chỉnh sửa tất cả các điểm cuối.
Khi tạo hoặc chỉnh sửa một điểm cuối, các tùy chọn sau có sẵn trong cửa sổ cấu hình:
- Phương thức yêu cầu. NHẬN, ĐĂNG, NHẤP, XÓA hoặc ĐÓNG.
- URL yêu cầu. Phần đầu tiên với đường dẫn đến máy chủ không được chỉ định vì nó giống nhau đối với tất cả các điểm cuối ứng dụng. Ví dụ, nó là đủ để đặt phần cuối, ví dụ, / người dùng. Tham số URL cũng được chỉ định ở đây. Giả sử điểm cuối được thiết kế để nhận thông tin về một người dùng cụ thể. Trong trường hợp đó, ID của nó phải được viết sau ":" (/ users /: id) và được truyền dưới dạng tham số.
- Các nhóm điểm cuối. Tham số này nhằm mục đích tổ chức và cấu trúc công việc với các điểm cuối. Tất cả các điểm cuối có thể được chia thành các nhóm (thư mục).
- Quy trình kinh doanh. Một trong những tham số quan trọng nhất xác định điểm cuối 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 tương tự tại địa chỉ cũ và nếu quy trình nghiệp vụ được thay thế, nó sẽ thực hiện một chức năng khác. Các quy trình nghiệp vụ cho các hoạt động cơ sở dữ liệu cơ bản được tạo tự động. Bạn không thể chỉnh sửa chúng, nhưng nếu cần, bạn có thể thay thế chúng bằng các BP tùy chỉnh.
Ngoài ra, bạn có thể thiết lập phần mềm trung gian. Phần mềm trung gian là phần mềm trung gian đóng vai trò như một bộ lọc khi xử lý các yêu cầu của ứng dụng. Phần mềm trung gian được sử dụng để kiểm tra bất kỳ điều kiện nào trước khi thực hiện một yêu cầu. Ví dụ: nếu bạn tạo phần mềm trung gian để kiểm tra xác thực người dùng, phần mềm trung gian sẽ chuyển hướng người dùng đến trang đăng nhập nếu người dùng chưa đăng nhập. Nếu anh ta đã đăng nhập, phần mềm trung gian sẽ không can thiệp vào quá trình xử lý yêu cầu, chuyển nó đến khách hàng.
Tạo điểm cuối trong AppMaster.io
Chúng ta hãy xem xét cấu hình của các điểm cuối trong thực tế và phân tích nó qua ví dụ của dự án Aviato. Bạn có thể tìm thấy toàn bộ quá trình tạo dự án này trên khóa học AppMaster.io .
Trong dự án, chúng tôi đã tạo ra hai quy trình kinh doanh:
- Xác thực và tạo chuyến bay - quy trình sẽ được sử dụng để thay thế quy trình Tạo chuyến bay;
- Đăng ký hành khách - để đăng ký một hành khách cho một chuyến bay cụ thể.
Bây giờ chúng ta có thể sử dụng các quy trình này để thiết lập các điểm cuối trong dự án.
Hãy bắt đầu với Quy trình xác thực và tạo chuyến bay. Nhóm Chuyến bay đã có điểm cuối POST / chuyến bay để tạo chuyến bay. Bây giờ chúng ta cần thay thế quy trình nghiệp vụ được đính kèm bằng một quy trình mới. Để làm điều này, chúng ta cần phải Chỉnh sửa điểm cuối.
Trong cửa sổ cấu hình, chọn quy trình kinh doanh mong muốn. Trong trường hợp của chúng tôi, đây là Xác thực và tạo BP chuyến bay. Sau đó, chúng ta cần chọn tất cả các biến đầu vào được yêu cầu và lưu các thay đổi.
Bây giờ chúng ta có thể thiết lập điểm cuối tiếp theo cho quy trình Đăng ký kinh doanh hành khách.
Mục tiêu của chúng tôi là tạo một phần để xem một chuyến bay cụ thể và những hành khách liên quan đến chuyến bay đó và thiết lập quy trình đăng ký hành khách mới.
Trong nhóm điểm cuối Chuyến bay, chúng tôi cần tạo một điểm cuối mới: / chuyến bay /: id / register, trong đó id đề cập đến một chuyến bay cụ thể mà chúng tôi có thể sử dụng làm đầu vào trong quy trình kinh doanh.
Bằng cách nhấp vào biểu tượng Dấu cộng, chúng ta có thể thêm một điểm cuối mới. Phương thức yêu cầu sẽ là POST vì chúng ta đang tạo một đối tượng mới. Chúng tôi chọn quy trình Đăng ký hành khách cho BP của chúng tôi và lưu tất cả các thay đổi đã thực hiện.
Đó là cách dễ dàng tạo điểm cuối trên nền tảng AppMaster.io. Video hướng dẫn đầy đủ:
Sự kết luận
Điểm cuối đóng một vai trò quan trọng trong hoạt động của API, do đó, cần thiết để mở rộng các dự án và tích hợp thuận tiện các dịch vụ và ứng dụng. Nền tảng không mã AppMaster.io giúp dễ dàng làm việc với các thiết bị đầu cuối tạo và cấu hình chúng. Bạn luôn có thể đăng ký trên nền tảng và kiểm tra tất cả các chức năng.
