Endpoint là gì?

API Endpoint là một “điểm vào” cụ thể trong API và là phần quan trọng nhất trong documentation của API.

Endpoint là thứ chính bạn sẽ sử dụng để đưa ra yêu cầu (request). Vì vậy, nếu các endpoint của API không được liệt kê rõ ràng trong documentation thì về cơ bản API không thể sử dụng được.

Để thực hiện một yêu cầu API (request, call), bạn cần tạo một đường dẫn (path) URL API. Điều này thường được thực hiện bằng cách thêm một endpoint vào base URL của API mà bạn đã chọn.

Nghe có vẻ khó hiểu?. Chỉ cần nghĩ về các API giống như các website. Để truy cập một trang web, bạn cần có base URL của nó.

apipheny.io

Nhưng để đến bất kỳ đâu ngoài Trang chủ (Homepage) - như trang Hỗ trợ (Support) hoặc Giới thiệu (About) - bạn cần thêm các từ khóa nhất định vào base URL.

apipheny.io/support
apipheny.io/about

Trong ngữ cảnh của API, các trang /support và /about của một trang web giống như các endpoint của API. Chúng là các "điểm vào" khác nhau.

Bạn biết rất rõ rằng trang Hỗ trợ sẽ hiển thị cho bạn thông tin khác với thông tin bạn thấy trên trang Giới thiệu. Và đó là bởi vì cả hai đều cung cấp các bộ dữ liệu khác nhau.

Khái niệm này đúng ngay cả trong ngữ cảnh của API.

Nếu bạn truy cập một API thông qua các endpoint khác nhau của nó, bạn có thể mong đợi các phản hồi khác nhau cho từng endpoint

Endpoint là bất kỳ thiết bị nào kết nối với mạng máy tính. Khi Bob và Alice nói chuyện điện thoại, kết nối của họ mở rộng từ người này sang người kia và các endpoint của kết nối là điện thoại tương ứng của họ. Tương tự, trong một mạng các thiết bị máy tính có "cuộc trò chuyện" với nhau, nghĩa là chúng truyền thông tin qua lại. Cũng giống như Bob là một endpoint trong cuộc trò chuyện của anh ấy và Alice, một máy tính được kết nối với mạng là một endpoint của quá trình trao đổi dữ liệu đang diễn ra.

Các ví dụ về các endpoint bao gồm máy tính để bàn, điện thoại thông minh, máy tính bảng, máy tính xách tay và thiết bị internet vạn vật (IoT). Các ví dụ về các thiết bị không phải endpoint bao gồm router, switch, network gateway, firewall, load balancer.