WordPress REST API là gì? Hướng Dẫn Sử Dụng Chi Tiết

WordPress REST API là một trong những công cụ hỗ trợ đắc lực cho nhà phát triển web trong quá trình xây dựng website, phần mềm ứng dụng hay mở rộng trang web trên nền tảng WordPress. Để tìm hiểu WordPress REST API là gì, các quy tắc cơ bản và cách sử dụng WordPress REST API, hãy cùng chúng tôi tham khảo qua bài viết được chia sẻ dưới đây!

API là gì?

API là giao diện lập trình ứng dụng  trong tiếng anh là Application Programming Interface. API cho phép các hệ thống có thể tương tác và làm việc với nhau một cách dễ dàng hơn, ví dụ như khi bạn thêm Google Map vào WordPress, thì tức là bạn đang cấp phép cho website và API tương tác trên ứng dụng Google Map.

Mỗi WordPress sẽ có nhiều API để phục vụ cho các plugin, cài đặt hoặc các đoạn code ngắn để nhà phát triển sử dụng khi tương tác với WordPress core. Bên cạnh đó, API REST còn cung cấp bản cài đặt WordPress cho các hệ thống bên ngoài để tương tác một cách linh hoạt với máy chủ.

Rest là gì?

Rest hay còn gọi là Representational State Transfer, được hiểu là tập hợp tất cả hướng dẫn mà hệ thống trang web sử dụng để giao tiếp với nhau một cách dễ dàng nhất. Điều này đồng nghĩa với việc REST chính là nguồn cung cấp thông tin để hai hệ thống web có thể hiểu và truyền tải dữ liệu qua lại cho nhau.

REST bao gồm một số ràng buộc liên quan đến các ứng dụng, trang web, đồng thời chi phối ứng dụng để giao tiếp với API. Trong RESTful API – tiêu chuẩn dùng trong quá trình thiết kế API cho ứng dụng web, API sẽ tuân theo các tiêu chuẩn, quy tắc riêng của REST, cụ thể là:

• Thống nhất địa chỉ URL để truy cập vào các tài nguyên trong hệ thống.
• Phần phân tách mô hình Client – Server để hệ thống hoạt động độc lập.
• Khi có một yêu cầu được thực hiện bởi API, server sẽ không thay đổi trạng thái và cũng không lưu trữ yêu cầu.
• Các tài nguyên sẽ được lưu trữ trong cache nhằm mục đích cải thiện tốc độ tải trang và tuân thủ theo các tiêu chuẩn web.
• Hệ thống RESTful được phép truy cập thông qua nhiều lớp khác nhau và dữ liệu sẽ được lưu trữ ở các server trung gian.

Vai trò của REST, API trong WordPress

Cả REST lẫn API đều được ví như một bộ mã được thiết kế với mục đích hỗ trợ các hệ thống, chương trình có thể giao tiếp với WordPress theo một hướng dẫn, quy chuẩn nhất định. Nói một cách đơn giản thì REST và API sẽ là một ứng dụng di động hoặc trang web của bên thứ 3 có quyền truy cập vào database của WordPress và nhận dữ liệu từ đó.

WordPress REST API là gì?

WordPress REST API là một trong những công cụ hỗ trợ đắc lực cho nhà phát triển web trong quá trình xây dựng website, ứng dụng hay WordPress mở rộng.

Sự phát triển của WordPress REST API

REST API của WordPress được triển khai vào tháng 12/2016 và đã chính thức trở thành một trong những thành phần chính trong phiên bản 4.7 với cách thức hoạt động tương tự như một plugin. WordPress REST API được phát triển với hai mục đích chính, một là hỗ trợ cho các ứng dụng được xây dựng trên nền tảng WordPress, hai là chuyển đổi WordPress từ một nền tảng quản lý nội dung sang một nền tảng ứng dụng.

WordPress.com ứng dụng REST API dựa trên nền tảng ngôn ngữ lập trình JavaScript để truy cập, tương tác với nội dung, dữ liệu của WordPress. Ngoài ra, Gutenberg Editing Interface cũng sử dụng nền tảng này để giao tiếp với database WordPress vào năm 2019.

REST API đã trở thành một phương pháp cung cấp tài nguyên cho ứng dụng web hoặc SPA (Single Page Application) dựa trên web phổ biến hàng đầu hiện nay. Trong đó, SPA là một loại ứng dụng web mà trong đó, mọi thay đổi, tương tác của người dùng đều sẽ diễn ra trên một trang duy nhất, thay vì tải lại toàn bộ trang mỗi khi người dùng thực hiện thao tác bất kỳ.

Những quy tắc cơ bản khi sử dụng REST API

REST API là một API được phát triển dựa trên bộ quy tắc cụ thể. Trong quá trình xây dựng API, nhà phát triển web cần phải tuân thủ theo những nguyên tắc đó để đảm bảo rằng API có thể hoạt động một cách ổn định, hiệu quả.

Dưới đây là 5 yếu tố cơ bản giúp API trở nên “RESTful”:

Kiến trúc client-server

Khi xây dựng API, bạn cần đảm bảo rằng hai thành phần client và server là tách biệt nhau. Qua đó, mỗi một thành phần đều có thể tự phát triển và cho phép sử dụng một cách độc lập.

Không trạng thái

API REST không lưu trữ thông tin client và hoàn thành yêu cầu trong một lần giao tiếp. Điều này giảm thiểu bộ nhớ và lỗi trong quá trình hoạt động.

Cho phép cache

Cache hay bộ nhớ đệm là nơi lưu trữ dữ liệu tạm thời mà qua đó, dữ liệu có thể được truy xuất và trả kết quả một cách nhanh chóng hơn. Các RESTful API thường lưu dữ liệu vào cache để cải thiện hiệu năng và tốc độ làm việc. Ngoài ra, API cũng đảm nhận nhiệm vụ cung cấp thông tin để client biết dữ liệu phần tử nào được lưu vào cache.

Hệ thống phân lớp

REST API được tạo dựng từ nhiều lớp, mỗi lớp sẽ được chỉ định một chức năng riêng. Mặc dù các lớp này tương tác với nhau nhưng chúng lại hoàn toàn tách biệt. Qua đó, API có thể dễ dàng sửa đổi, cải thiện và cập nhật để hoàn thiện hơn.

Interface thống nhất

Tất cả thành phần của REST API đều hoạt động trên một interface (giao diện) và chúng giao tiếp với nhau qua một ngôn ngữ chung. Đặc biệt, interface được thiết kế dành riêng cho API này có khả năng tự phát triển và không phụ thuộc vào Server lẫn client.

Tất cả các API đều phải tuân thủ theo bộ nguyên tắc – hay còn được gọi là RESTful. Ngoài ra, còn có một quy tắc khác mang tên code on demand. Quy tắc này cho phép API mở rộng chức năng bằng cách hướng dẫn hệ thống server truyền mã đến client. Tuy nhiên, đây là một tùy chọn và không phải REST API nào cũng có.

Ý nghĩa của WordPress REST API đối với người dùng và nhà phát triển web

WordPress REST API mang lại nhiều lợi ích nổi bật cho cả nhà phát triển web lẫn người dùng, cụ thể là:

Đối với người dùng: 

• Thay đổi giao diện, các tính năng chỉnh sửa Gutenberg để tạo nội dung một cách dễ dàng và linh hoạt hơn.
• Cải tiến các ứng dụng trên thiết bị di động, giúp các ứng dụng di động có thể tương tác với database của WordPress và hiển thị nội dung một cách nhanh chóng, mượt mà, từ đó cải thiện trải nghiệm người dùng.
• Màn hình WordPress Admin có tính năng tự lưu trữ tương tự như màn hình WordPress.com và người dùng có thể thực hiện các thay đổi mà không cần phải tải lại trang.

Đối với nhà phát triển web: 

• Là lựa chọn tối ưu cho những nhà phát triển không dùng PHP. WordPress REST API không bị ràng buộc bởi việc sử dụng PHP và các nhà phát triển có thể sử dụng ngôn ngữ lập trình khác để tương tác với WordPress.

• Cung cấp tính năng mở rộng như JavaScript, cho phép phát triển ứng dụng web và tích hợp các tính năng mới vào WordPress một cách nhanh chóng, dễ dàng.
• Cho phép xây dựng các Gutenberg block thay vì meta boxe, điều này giúp tăng tính tương tác và khả năng tùy chỉnh cho trang web.

>>> Xem thêm: WordPress Multisite là gì? Tìm Hiểu Từ A- Z Về WordPress Multisite

WordPress REST API request là gì?

Bất kỳ API nào cũng đều có thể xử lý yêu cầu và trả lại kết quả phản hồi, tức là client sẽ gửi request và API đảm nhận nhiệm vụ response bằng các câu lệnh HTML đơn giản.

Dưới đây là một số câu lệnh HTML cơ bản nhất mà client sử dụng:

• Lệnh GET: Lấy một tài nguyên từ server, một phần dữ liệu nào đó chẳng hạn.
• Lệnh POST: Thêm một tài nguyên vào server.
• Lệnh PUT: Cập nhật hoặc chỉnh sửa một tài nguyên đã có sẵn trên server.
• Lệnh DELETE: Xóa một tài nguyên trên server.

Khi sử dụng các dòng lệnh trên, client sẽ gửi kèm thông báo chính xác để chỉ định tài nguyên nào cần được xử lý. Chẳng hạn như khi client yêu cầu tải một file PHP lên thư mục cụ thể trên server, dòng lệnh sẽ là:

POST /foldername/my_file.php

Trong đó, /foldername/my_file.php được gọi là route vì thành phần này giúp API nhận biết được nó phải làm gì với dữ liệu nào. Khi người dùng kết hợp với phương thức HTTP, toàn bộ hàm sẽ được gọi với cái tên là endpoint.

Đa số các client và REST API sẽ tương tác với nhau theo cách phức tạp hơn rất nhiều. Tuy nhiên, về cơ bản, chúng được xem như nền tảng tạo giúp cho WordPress REST API hoạt động.

Những tài liệu bạn nên tham khảo về WordPress REST API

• REST API Handbook: Tài nguyên này ghi lại tất cả thông tin liên quan đến API REST.
• W3Schools tutorials: Tài nguyên này không chỉ đề cập đến mỗi REST API, nhưng nó vẫn hữu ích với hàng loạt hướng dẫn chi tiết để bạn có thể dễ dàng nắm bắt khái niệm chính liên quan đến REST API.
• The Ultimate Guide to the WordPress REST API: Đây là một ebook miễn phí được cung cấp bởi WP Engine. Ebook này cung cấp cho người đọc nhiều thông tin hữu ích cùng các ví dụ minh hoạt dễ hiểu.

Cách tiếp cận khác khi sử dụng WordPress API REST

Headless WordPress là một cách tiếp cận khá phổ biến trong việc ứng dụng WordPress REST API hiện nay. Thay vì sử dụng WordPress presentation tiêu chuẩn như thông thường, Headless WordPress sẽ tách rời hai thành phần chính của hệ sinh thái WordPress là backend và frontend. Điều này mang lại khả năng tích hợp dữ liệu dễ dàng, cải thiện tốc độ, hiệu suất và gia tăng mức độ linh hoạt khi cho phép người dùng phát triển ứng dụng với hệ thống WordPress core.

Trường hợp nào không sử dụng WordPress REST API?

Nếu bạn thuộc một trong những trường hợp sau, WordPress REST API chưa hẳn là một sự lựa chọn tối ưu dành cho bạn:

Khả năng tương thích

Các ứng dụng không phổ biến hoạt động trên thiết bị không hỗ trợ (hoặc tắt) JavaScript thường không thể chạy được khi sử dụng REST API. Dẫu vậy, điều này vẫn không ảnh hưởng nhiều đến WordPress site đã được mã hóa PHP và xuất ra HTML.

Khả năng tiếp cận

Những trang web được phát triển dựa trên ngôn ngữ JavaScript có thể gây ra một số vấn đề cho người dùng bị khiếm thị hoặc có thần kinh cảm quan không tốt. Vậy nên, bạn cần kiểm tra trang web và xem xét khả năng truy cập để biết được mình nên lựa chọn JavaScript hay HTML sẽ tốt hơn..

SEO

Các trang web, ứng dụng dạng SPA với tình trạng thường xuyên làm mới có thể nâng cao tính tương tác và mang lại trải nghiệm tốt hơn cho người dùng, nhưng nó đồng thời cũng tạo ra một số vấn đề về SEO.

Khi trang web thường xuyên làm mới, nội dung của trang sẽ thay đổi liên tục và các công cụ tìm kiếm như Google không thể nhận được toàn bộ nội dung trang khi trang được xuất vào lần đầu tiên. Sở dĩ có tình trạng này là vì JavaScript cần thời gian để tải và thực thi. Chính điều này sẽ gây ảnh hưởng đến đánh giá ban đầu của bot tìm kiếm và dẫn đến việc nội dung không được lập chỉ mục.

Hướng dẫn bạn cách sử dụng WordPress REST API

Bước 1: Đầu tiên, bạn truy cập vào WordPress REST API với địa chỉ: yoursite.com/wp-json/wp/v2

Bước 2: Tiếp theo, bạn thêm vào URL này để có thể truy cập vào nhiều loại dữ liệu khác nhau, chẳng hạn như tra cứu hồ sơ người dùng với router:

yoursite.com/wp-json/wp/v2/users/4567

Ngoài ra, bạn cũng có thể xem các dữ liệu khác một cách dễ dàng như page, post…

Để tìm kiếm các tập hợp con thuộc dữ liệu đáp ứng các tiêu chí cụ thể nào đó, ví dụ như tìm kiếm bài đăng chứa một cụm từ nhất định, bạn sử dụng URL sau:

yoursite.com/wp-json/wp/v2/posts?=search[keyword]

Bên trên chỉ là một vài ví dụ đơn giản, để tìm hiểu chi tiết hơn, bạn có thể xem thêm các tài liệu tham khảo ở phần tiếp theo của bài viết.

Hướng dẫn cách tắt WordPress REST API khi không sử dụng

Dưới đây là cách tắt dành cho cả những ai không muốn viết mã và không muốn viết mã:

#1. Sử dụng Plugin

Bước 1: Đăng nhập vào trang quản trị WordPress của bạn.

Bước 2: Trong menu bên trái, chọn “Plugins”

Bước 3: Bấm vào “Add New”

Bước 4: Tìm kiếm plugin “Disable REST API”

Bước 5: Cài đặt và kích hoạt plugin.

Bước 6: Trong trang cài đặt plugin, bạn có thể chọn tắt REST API hoặc tắt một số phần cụ thể của API theo ý muốn.

#2. Sử dụng mã code 

Để tắt WordPress REST API và năng ứng dụng không thể truy cập dữ liệu từ trang web qua REST API, bạn có thể sử dụng plugin Disable WP REST API và thêm hai dòng lệnh sau vào tệp chức năng functions.php của theme hiện tại hoặc viết một plugin cá nhân:

function disable_rest_api() {
return new WP_Error('rest_disabled', 'REST API is disabled', array('status' => 403));
}

add_filter('rest_authentication_errors', 'disable_rest_api');

Một số ứng dụng đang sử dụng WordPress REST API

Một số ứng dụng đang sử dụng WordPress REST API có thể kể đến như:

• WordPress.com
• The Block Editor (Gutenberg)
• Event Espresso
• UsTwo
• USA Today

FAQS ( Những Câu Hỏi Thường Gặp)

Restful API là gì?

RESTful API là một kiểu giao diện lập trình ứng dụng được thiết kế dựa trên các nguyên tắc của kiến trúc REST. REST là một kiến trúc phần mềm cho phép những ứng dụng giao tiếp với nhau thông qua giao thức HTTP một cách dễ dàng nhất.  RESTful API chia nhỏ một transaction ra thành nhiều các module nhỏ khác nhau.

Resource trong REST là gì?

Trong kiến trúc REST, “resource”  là một khái niệm quan trọng và đóng vai trò trung tâm. Resource đại diện cho một đối tượng hoặc dữ liệu cụ thể trong ứng dụng. Tại đây, Resource chính là những tài liệu, hình ảnh, dịch vụ tạm thời hoặc có thể là một nhóm các tài nguyên khác và cả những đối tượng không ảo như người, sinh vật cụ thể…

Lời kết

Như vậy, bài viết trên đã giúp bạn làm rõ WordPress REST API là gì và đồng thời cung cấp thêm một số thông tin cơ bản về WordPress REST API. Ngoài ra, đừng quên để lại câu hỏi thắc mắc tại phần Comment bên dưới để được hỗ trợ bởi đội ngũ Wiki.Lanit, bạn nhé!