Web API

Web API là giao diện lập trình ứng dụng cho máy chủ web hoặc trình duyệt web. Đây là khái niệm phát triển web, thường giới hạn ở phía máy khách (client-side) của ứng dụng web (bao gồm mọi khung web đang được sử dụng) và do đó thường không bao gồm máy chủ web (web server) hoặc chi tiết triển khai trình duyệt như SAPI hoặc API trừ khi có thể truy cập công khai từ xa ứng dụng web.

Phía máy chủ

Một Web API phía máy chủ là một giao diện lập trình bao gồm một hoặc nhiều điểm cuối (endpoint) cho một hệ thống các thông báo, hệ thống thông báo này xác định các yêu cầu (request) - phản hồi (response). Các thông báo yêu cầu - phản hồi được định nghĩa, thể hiện, truyền đi dưới dạng XML hoặc JSON.

Web API thực hiện đặc tả giao thức và do đó nó kết hợp các khái niệm như bộ nhớ đệm, URI, lập phiên bản, tiêu đề yêu cầu / phản hồi và các định dạng nội dung khác nhau trong đó.

Điểm cuối

Điểm cuối là khía cạnh quan trọng của việc tương tác với các Web API phía máy chủ, vì chúng chỉ định vị trí tài nguyên mà phần mềm bên thứ ba có thể truy cập. Thông thường, để truy cập tới điểm cuối, chương trình đẩy một request HTTP đến điểm cuối thông qua URI, và tiếp đó, chương trình sẽ mong đợi một response được trả về. API web có thể là công khai hoặc riêng tư; với API riêng tư, điểm cuối yêu cầu access token.

Các điểm cuối cần phải tĩnh, nếu không sẽ không thể đảm bảo hoạt động chính xác của chương trình phần mềm tương tác với nó. Nếu vị trí của tài nguyên thay đổi (tương ứng với việc đó là điểm cuối ) thì phần mềm được viết trước đó sẽ bị hỏng, vì tài nguyên cần thiết không còn được tìm thấy ở nơi đã được chỉ định nữa.

Tuy là tĩnh, nhưng các nhà cung cấp API vẫn muốn cập nhật các API web của họ, vậy nên các nhà phát triển đã giới thiệu hệ thống lập phiên bản trong URI trỏ đến một điểm cuối. Ví dụ với Clarifai API: điểm cuối cho chức năng gắn thẻ trong API web có URI sau: "https://api.google.com/v1/tag/". Trong URI đó, kí hiệu "/v1/" chỉ định quyền truy cập vào phiên bản đầu tiên của API web. Nếu Clarifai quyết định cập nhật lên phiên bản hai, họ có thể thực hiện việc này trong khi vẫn duy trì hỗ trợ cho phần mềm của bên thứ ba sử dụng phiên bản đầu tiên.

Xem thêm

• Giao diện lập trình ứng dụng
• Trang web động
• HTML5 trong thiết bị di động
• Tổng quan về ngôn ngữ mô tả API RESTful
• REST
• Dịch vụ web
• Web API Tutorial Lưu trữ ngày 19 tháng 8 năm 2019 tại Wayback Machine
• Web API Interview Questions and Answers

Đọc thêm

• Jacobson, Daniel; Woods, Dan; Brail, Greg (tháng 11 năm 2011). APIs a strategy guide. Sebastopol, Calif: O'Reilly Media. ISBN 978-1-4493-0892-6.
• Mulloy, Brian. Web API Design - Crafting Interfaces that Developers Love (PDF). Apigee.
• "Web APIs". Google Chrome.
• "Web API reference - Web technology reference". Mozilla Developer Network.
• "Web API Demonstration". Web API Demonstration.