REST For Web Developers
REST là viết tắt của Representational State Transfer. Giải thích đơn giản, REST là một loạt hướng dẫn và dạng cấu trúc dùng cho việc chuyển đổi dữ liệu. Thông thường, REST hay được dùng cho ứng dụng web, nhưng cũng có thể làm việc được với dữ liệu phần mềm. API là viết tắt của Application Programming Interface, phương thức kết nối với các thư viện và ứng dụng khác. Windows có nhiều API, và Twitter cũng có web API, tuy chúng thực hiện các chức năng khác nhau, với mục tiêu khác nhau. Nhìn chung, RESTful API là những API đi theo cấu trúc REST.RESTful Là Gì ?
REST là viết tắt của cụm từ Representational State Transfer (đôi khi còn được viết là ReST) là một kiểu kiến trúc được sử dụng trong việc giao tiếp giữa các máy tính (máy tính cá nhân và máy chủ của trang web) trong việc quản lý các tài nguyên trên internet. REST được sử dụng rất nhiều trong việc phát triển các ứng dụng Web Services sử dụng giao thức HTTP trong giao tiếp thông qua mạng internet. Các ứng dụng sử dụng kiến trúc REST này thì sẽ được gọi là ứng dụng phát triển theo kiểu RESTful. Trong từ RESTful, thì từ ful (đọc là phù, phồ, phò hay phùn đều được) chính là suffix trong tiếng Anh, giống như từ help có nghĩa là giúp đỡ thì từ helpful là rất hữu ích.Cấu trú REST
Thật khó giải thích sao cho cụ thể. Tuy nhiên, vẫn có một số quy luật bất biến, như:- Sự nhất quán trong cả API
- Tồn tại không trang thái (ví dụ, không có server-side session)
- Sử dụng HTTP status code khi cần thiết
- Sử dụng URL endpoint với logical hierarchy
- Versioning trong URL chứ không phải trong HTTP header
Cần chú ý với RESTful APIs
Nhìn chung, có bốn lệnh dùng để truy cập RESTful API:- GET để truy vấn object
- POST để tạo object mới
- PUT để sửa đổi hoặc thay thế một object
- DELETE để loại bỏ một object
Truy cập API Resources
Public API thường truy cập được từ địa chỉ website trực tiếp. Nói cách khác, cấu trúc URL rất quan trọng, chỉ nên dùng cho API request. Một số URL có thể bao gồm đường dẫn tiền tố như /v2/ cho phiên bản 2 cập nhật từ API trước đó; hay thấy ở những lập trình viên muốn giữ 1.x API, nhưng vẫn muốn cung cấp cấu trúc mới nhất. Nên nhớ, return data ở endpoint sẽ thay đổi mạnh mẽ dựa vào phương thức HTTP. Ví dụ, GET trả nội dung, còn POST tạo nội dung mới. Request có thể chỉ đến cùng một endpoint, nhưng kết quả có thể rất khác.Tự build API
Quá trình xây dựng một API riêng không dễ dàng, nhưng cũng không quá phức tạp như nhiều người nghĩ. Mỗi API phải kết nối đến server để trả dữ liệu. Bạn không những phải viết code để làm điều đó, mà còn phải format return data nữa. Một số yêu cầu khác có thể gồm authentication và rate limiting. Hãy điểm qua một số nguyên lý cơ bản của cấu trúc API.Tài liệu nghiên cứu
Luyện tập vẫn là cách lập trình nhanh nhất. Những lý thuyết đã qua kiểm chứng luôn đáng để bạn học hỏi, vì qua đó bạn có thể tranh luận với những lập trình viên khác và hiểu được nguyên lý đằng sau lý thuyết đó. Kết nối với các API khác trước cũng là một cách học hỏi hay. Hãy tìm hiểu về các điểm cơ bản nhất của kết nối client-side, và từ đó bạn có thể chuyển sang phát triển API, tạo API riêng từ con số không. Bạn có thể tham khảo một số tài liệu dưới nếu muốn đi theo con đường API này.Sách
- REST API Design Rulebook
- RESTful Web APIs
- RESTful Web Services Cookbook
- Undisturbed REST: A Guide to Designing the Perfect API
Bài viết
- A Beginner’s Guide to HTTP and REST
- Creating a RESTful API
- RESTful Resource Naming Guide
- Creating A REST API using the MEAN Stack
Postman là gì ?
Cài đặt
Truy cập trang chủ https://www.getpostman.com/ hoặc từ Chrome Web Store.Cách sử dụng
Sau khi cài đặt, các bạn bấm vào app, chọn Postman, giao diện đăng nhập sẽ hiện ra. Bạn có thể bấm “Skip This” để bỏ qua phần đăng nhập, tuy nhiên mình khuyến khích nên tạo account và đăng nhập vì Postman có thể đồng bộ dữ liệu của bạn trên nhiều máy, khá tiện lợi. Bạn có thể sử dụng phương thức đăng nhập bằng Google. Sau khi bạn đăng nhập thành công giao diện chính sẽ hiện raMột số khái niệm
Request: Để sử dụng RestAPI, ta sẽ gửi một HTTP Request tới endpoint của API đó. Ví dụ như để lấy thông tin người dùng github có username là conanak99, ta sẽ gửi HTTP GET Request tới endpoint: https://api.github.com/users/conanak99. Mỗi request này chứa những thông tin như URL, method (POST, GET), body (trường hợp dùng POST hay PUT), HTTP header. Collection: Collection là một tập hợp của nhiều request. Những request liên quan tới nhau thì ta gom lại vào chung 1 collection để dễ quản lý hơn. Enviroment và variable: Trong dự án thực tế, người ta thường dùng deploy RestAPI trên nhiều môi trường (local, test, production). Postman hỗ trợ cài đặt các biến môi trường (url gốc, API key, …), thuật tiện hơn khi cần test trên nhiều môi trườngCác chức năng cơ bản của postman
Các chức năng hay được sử dụng của Postman bao gồm:- Cho phép gửi HTTP Request với các method GET, POST, PUT, DELETE.
- Cho phép thay đổi header header của các request
- Cho phép post dữ liệu dưới dạng form (key-value), text, json
- Hiện kết quả trả về dạng text, hình ảnh, XML, JSON
- Hỗ trợ authorization (Oauth1, 2)
Kết
Qua bài hướng dẫn này, bạn đã có cái nhìn tổng quát về của Postman, đồng thời biết cách sử dụng những chức năng chính của nó. Postman rất hữu dụng với các Web Developer khi bạn cần test cách truyền params hoặc xem kết quả trả về từ một RestAPI nào đó. Ngoài ra, Postman còn có các chức năng khá hay như: Viết và chạy test case cho API, export collection để chía sẻ với người khác, các bạn có thể tự mày mò tìm hiểu thêm. Chúc các bạn thành công. Nếu thấy bài viết này có ích đừng quên Like Share để ủng hộ Movan.vn nhé Nếu bạn có câu hỏi hay thắc mắc gì thì cứ comment trong bài nhé.
Leave a Comment