API bài đăng WordPress

Nếu bạn đã ở trong không gian WordPress một thời gian, có lẽ bạn đã nghe nói về WordPress REST API. Nếu đã thực hiện bất kỳ nghiên cứu nào, bạn có thể đã thực sự bị đe dọa bởi những gì bạn tìm thấy — cụ thể là RẤT NHIỀU thuật ngữ kỹ thuật và dường như không có hướng dẫn rõ ràng về cách sử dụng thuật ngữ đó trong thực tế

Hôm nay tôi sẽ chỉ cho bạn (người hoàn toàn mới bắt đầu) cách sử dụng WordPress REST API. Trước tiên, tôi sẽ chỉ cho bạn cách lấy một số dữ liệu từ một trang web WordPress khác. Sau đó, tôi sẽ giới thiệu một vài thuật ngữ chính sau khi bạn thấy nó hoạt động như thế nào

Trước khi chúng tôi bắt đầu, hãy mở Chrome và cài đặt tiện ích mở rộng Trình xem JSON. Khi bạn thử các ví dụ bên dưới, đầu ra sẽ được trình bày ở định dạng dễ đọc hơn nhiều

Sử dụng API REST của WordPress

Để sử dụng API REST của WordPress, chỉ cần thêm _____0 vào cuối URL trang web WordPress của bạn. Điều này sẽ cung cấp cho bạn một danh sách các bài đăng (ở định dạng JSON). Số lượng bài đăng mặc định được trả về là 10, nhưng bạn có thể chọn hiển thị nhiều hơn hoặc ít hơn với đối số per_page — chúng tôi sẽ nói về điều đó bên dưới

Ví dụ: truy cập https. // ren morozowich. com/wp-json/wp/v2/bài viết. Bạn làm được rồi. Bạn vừa sử dụng WordPress REST API để xem 10 bài đăng gần đây của tôi. Dễ dàng, phải không?

Đối số để trả về bài viết cụ thể

Ngoài ra còn có một số bạn có thể thêm vào để nhận các bài đăng cụ thể

per_page sẽ cho phép bạn chỉ định số lượng kết quả bạn muốn trả về. Ở đây tôi đang tìm kiếm hai bài đăng blog gần đây nhất. https. // ren morozowich. com/wp-json/wp/v2/posts?per_page=2

order sẽ cho phép bạn chỉ định cách trả về kết quả, theo thứ tự giảm dần (mặc định) hoặc tăng dần. Ở đây tôi đang tìm kiếm các bài đăng trên blog của mình theo thứ tự tăng dần. https. // ren morozowich. com/wp-json/wp/v2/posts?order=asc

categories sẽ hiển thị cho bạn các bài đăng từ một danh mục cụ thể. (Bạn phải biết ID, bạn có thể tìm thấy ID này nếu thêm /wp-json/wp/v2/categories vào cuối URL chính của mình. ) Ở đây tôi đang tìm kiếm các bài đăng trong danh mục Kỹ thuật (ID 45). https. // ren morozowich. com/wp-json/wp/v2/posts?categories=45

search sẽ hiển thị các bài đăng bao gồm một cụm từ tìm kiếm cụ thể. Ở đây tôi đang tìm kiếm tất cả các bài đăng của mình để tìm từ plugin. https. // ren morozowich. com/wp-json/wp/v2/posts?=search[plugin]

Một ví dụ sử dụng API REST

Tôi đã viết một plugin nhỏ để lấy hai bài đăng gần đây từ Sumy Designs, một công ty thiết kế web ở Indiana. Tên bài đăng, ngày tháng và permalink được trả về

Đây là đầu ra

Cách bán sách trực tuyến 19/12/2022
Bạn muốn làm SEO nhưng không biết bắt đầu từ đâu? . 22/12/2022

Nếu bạn truy cập lại trang này sau vài ngày nữa, bạn sẽ thấy rằng các bài đăng sẽ thay đổi. API REST đang nhận hai bài đăng gần đây nhất, sẽ thay đổi mỗi khi họ xuất bản một bài đăng mới.

Và đây là mã

Để triển khai, hãy lưu mã và tải mã lên thư mục plugin của bạn. Sau đó, thêm mã ngắn [sc_get_posts_via_rest] vào bài đăng hoặc trang của bạn

Một số thuật ngữ chính

Sẽ thật thiếu sót nếu không đề cập đến một số thuật ngữ chính

API

Giao diện lập trình ứng dụng - các quy tắc chỉ định cách để hai hệ thống riêng biệt nói chuyện với nhau. Hãy xem API là gì và tại sao tôi nên sử dụng một API?

CÒN LẠI

Chuyển trạng thái đại diện - một loại API cụ thể được sử dụng trên web. REST là gì?

JSON

Ký hiệu đối tượng JavaScript — một định dạng dữ liệu mà con người có thể đọc được trông giống như các đối tượng trong JavaScript

phương thức HTTP

Trong tất cả các ví dụ trên, chúng tôi đang sử dụng phương thức HTTP GET để tải bài đăng. Chúng tôi đưa ra yêu cầu trong trình duyệt (Xin chào trang web WordPress, cung cấp cho tôi hai bài đăng gần đây nhất) và máy chủ sẽ gửi lại phản hồi (Đây là hai bài đăng gần đây nhất)

Bạn cũng có thể ĐĂNG, ĐẶT hoặc XÓA (để kể tên một số) điều này sẽ thực sự thay đổi dữ liệu bằng cách thêm, thay đổi hoặc xóa dữ liệu đó. Trong những trường hợp này, bạn cần xác thực để có thể sửa đổi dữ liệu. Đọc về 7 phương thức HTTP tại đây

Tuyến đường và Điểm cuối

Điểm cuối là một chức năng có sẵn thông qua API. Mỗi điểm cuối thực hiện một nhiệm vụ cụ thể;

Tuyến đường là tên bạn sử dụng để truy cập điểm cuối. Lộ trình đến bài đăng này là wp/v2/posts/2065 (_______8 là đường dẫn cơ sở cho chính API). Trong tuyến đường này, có nhiều điểm cuối khác nhau

Sẵn sàng để biết thêm?

Nếu bạn muốn tìm hiểu thêm về API REST, hãy xem sổ tay

lynda. com có ​​lộ trình học tập tuyệt vời — Trở thành Nhà phát triển API RESTful. (Kiểm tra với thư viện địa phương của bạn để xem họ có cung cấp lynda miễn phí không. đăng ký com với tư cách thành viên của bạn. ) Udemy cũng có một khóa học — Trở thành Nhà phát triển WordPress. Mở khóa sức mạnh bằng mã

Giao diện lập trình ứng dụng (API) (đôi khi được gọi là WP JSON REST API)  là một loại phần mềm cho phép hai ứng dụng hoạt động với nhau bằng cách trao đổi thông tin. Có một số loại API bạn có thể sử dụng, bao gồm các tùy chọn Chuyển trạng thái đại diện (REST). API REST về cơ bản là phần mềm cho phép hai ứng dụng trao đổi dữ liệu bằng cách sử dụng một bộ ràng buộc cụ thể

Đặc biệt, WordPress REST API cho phép bạn kết nối trang web WordPress của mình với các ứng dụng bên ngoài. Điều này có nghĩa là bạn có thể phát triển ứng dụng dành cho thiết bị di động bằng cách sử dụng thực tế bất kỳ ngôn ngữ lập trình nào và sử dụng API WP REST để tìm nạp dữ liệu từ WordPress. Theo một cách nào đó, API REST cung cấp một cách để giải phóng bạn khỏi cấu trúc vốn có của WordPress, đồng thời khai thác nó để giúp bạn tạo một ứng dụng

Mục lục

Trong hướng dẫn WordPress này, chúng tôi sẽ chia nhỏ cách hoạt động của WordPress REST API và giúp bạn bắt đầu với nó từ đầu. Cùng bắt tay vào làm

Cách thức hoạt động của WordPress REST API

Trước đây, bạn cần một plugin WordPress để truy cập API WordPress JSON REST. Tuy nhiên, kể từ Phiên bản 4. 4, API WordPress này đã trở thành một phần của phần mềm cốt lõi. Như vậy, để sử dụng API REST, bạn chỉ cần biết cách tương tác với nó, nghĩa là sử dụng bốn loại phương thức HTTP khác nhau như một phần yêu cầu của bạn

  • ĐƯỢC. Với phương pháp này, bạn có thể lấy thông tin từ máy chủ
  • BƯU KIỆN. Điều này cho phép bạn gửi thông tin đến máy chủ được đề cập
  • ĐẶT. Với phương thức put, bạn có thể chỉnh sửa và cập nhật dữ liệu hiện có
  • XÓA BỎ. Điều này cho phép bạn xóa thông tin

Ví dụ, xem xét điều gì sẽ xảy ra khi bạn truy cập trang đăng nhập WordPress của mình. Trình duyệt của bạn gửi một yêu cầu GET tới máy chủ, máy chủ này sẽ xử lý nó bằng API của chính nó. Sau khi tải trang, bạn nhập thông tin đăng nhập của mình và gửi chúng qua yêu cầu POST. Nếu bạn muốn thay đổi mật khẩu của mình, nó liên quan đến phương thức PUT, trong khi xóa hoàn toàn tài khoản của bạn sẽ sử dụng DELETE

Chúng tôi sẽ chỉ cho bạn các ví dụ về cách sử dụng các phương pháp này với WordPress REST API sau một phút. Bây giờ, hãy xem qua một số khái niệm khác mà bạn cần hiểu trước

Làm quen với WordPress REST API

Để thực sự hiểu cách thức hoạt động của WordPress REST API, có một số mẹo và khái niệm bạn cần làm quen. Khi chúng tôi đến với các ví dụ thực tế trong thời gian ngắn, bạn sẽ thấy mọi thứ hoạt động như thế nào trong thực tế

Các khái niệm và thuật ngữ API REST

Khi sử dụng WordPress REST API, bạn sẽ thấy các thuật ngữ giống nhau xuất hiện lặp đi lặp lại, bao gồm

  • 'Tuyến đường' và 'điểm cuối'. Tuyến đường là một URL bạn nhập để thực hiện yêu cầu, trong khi điểm cuối là sự kết hợp của một URL với một phương thức HTTP
  • yêu cầu. Khi bạn gửi một điểm cuối, bạn đang gửi yêu cầu tới máy chủ
  • phản hồi. Nếu điểm cuối của bạn được cấu trúc đúng cách, bạn sẽ nhận được phản hồi bao gồm thông tin bạn muốn trong Ký hiệu đối tượng JavaScript (JSON) hoặc lỗi
  • lược đồ. Mọi phản hồi bạn nhận được đều tuân theo các cấu trúc tương tự, được điều chỉnh bởi các lược đồ tích hợp
  • lớp điều khiển. Bạn có thể sử dụng những thứ này để xây dựng các tuyến đường và điểm cuối của riêng mình, nhưng điều này thuộc về việc sử dụng API WordPress REST nâng cao hơn

Điểm cuối API REST

Trong hầu hết các trường hợp, bạn sẽ sử dụng các tuyến và điểm cuối đã tồn tại để gửi yêu cầu qua WordPress REST API. Biết những điểm cuối này là gì là bước đầu tiên để thành thạo WP API và sử dụng nó để phát triển các dự án của riêng bạn

Xác thực API REST

Như bạn có thể mong đợi, WordPress sẽ không cho phép bạn truy cập một số dữ liệu WordPress nhất định trừ khi nó có thể chứng thực bạn là ai và liệu bạn có đang yêu cầu dữ liệu đó qua trình duyệt hay API REST hay không. Ví dụ: nếu bạn muốn cập nhật hoặc xuất bản một bài đăng thông qua các lệnh, bạn sẽ cần tìm hiểu kiến ​​thức cơ bản về xác thực

Ví dụ sử dụng API WordPress REST

API REST đang được đưa vào sử dụng thực tế trên một số trang web lớn. Để cung cấp cho bạn một số ý tưởng về các tính năng mà bạn có thể triển khai, hãy xem một số ví dụ về REST API WordPress

Nước Mỹ ngày nay

API bài đăng WordPress

Trang web USA Today đã được xây dựng lại bằng API WordPress REST, để tạo điều kiện tích hợp với các trang web khác và dịch vụ của bên thứ ba. Điều này cho phép nó dễ dàng đẩy nội dung lên các dịch vụ như Facebook và Apple News

WordPress. com

API bài đăng WordPress

Đương nhiên, WordPress. trang web com sử dụng rất nhiều API WP. Trong trường hợp này, nó nằm ở mặt sau, với các trang quản trị được xây dựng hoàn toàn bằng API

Thời báo New York

API bài đăng WordPress

Thời báo New York tận dụng API WP REST để chạy một blog trực tiếp, nơi các nhà báo có thể thêm các diễn biến tin tức quan trọng trong thời gian thực. Họ thậm chí có thể đăng lên blog trực tiếp từ Slack nhờ API, cho phép quy trình làm việc liền mạch hơn

Cách bắt đầu sử dụng WordPress REST API (Trong 3 bước)

Cho đến nay, chúng ta đã xem qua rất nhiều lý thuyết, vì vậy đã đến lúc chuyển sang hướng dẫn về điểm cuối WordPress. Đối với phần này, chúng tôi sẽ chỉ cho bạn cách truy cập API REST, lấy lại danh sách dữ liệu cụ thể và thêm thông tin mới bằng điểm cuối. Cùng bắt tay vào làm

Bước 1. Truy cập API REST

Bạn có thể 'truy cập' WordPress REST API từ bất kỳ ứng dụng nào có thể gửi điểm cuối HTTP. Ví dụ: nếu bạn nhập lệnh sau trong trình duyệt yêu thích của mình, bạn sẽ nhận được danh sách các bài đăng WordPress của mình ở định dạng JSON

NHẬN trang web của bạn. com/wp-json/wp/v2/bài đăng

Tuy nhiên, bạn sẽ cần thay thế URL giữ chỗ bằng URL của trang web của riêng bạn. Bạn cũng cần sử dụng phiên bản WordPress lớn hơn 4. 4 để yêu cầu API REST hoạt động (điều mà bạn nên thực hiện)

Nếu bạn thực sự muốn thử nghiệm với API REST, thông qua, trình duyệt không phải là công cụ tốt nhất để làm điều đó. Thay vào đó, chúng tôi khuyên bạn nên sử dụng dòng lệnh, cung cấp cách tiếp cận linh hoạt hơn

Bước 2. Tìm nạp một bài đăng cụ thể bằng API REST

Lệnh cuối cùng bạn đã chạy sẽ trả về danh sách tất cả các bài đăng trên WordPress của bạn, bao gồm cả ID bài đăng của chúng. Để tìm nạp một bài đăng cụ thể bằng ID của nó, bạn sẽ sử dụng một điểm cuối như thế này

NHẬN trang web của bạn. com/wp-json/wp/v2/bài đăng/535

Ví dụ: điều này sẽ lý tưởng để hiển thị một bài đăng WordPress cụ thể được dịch trong ứng dụng dành cho thiết bị di động. Tuy nhiên, WordPress REST API cho phép bạn tìm nạp tất cả các loại dữ liệu từ WordPress, vì vậy các ứng dụng thực tế của nó rất linh hoạt

Tuy nhiên, giả sử bạn muốn sử dụng API REST để thêm siêu dữ liệu vào một bài đăng đã chọn thay vì chỉ tìm nạp nó. Nói cách khác, bạn sẽ sử dụng phương thức POST thay vì GET

Bước 3. Thêm siêu dữ liệu vào một bài viết cụ thể

Giả sử rằng bạn đã tự xác thực, bạn có thể thêm dữ liệu mới vào bất kỳ bài đăng nào của mình bằng cách sử dụng yêu cầu tương tự như yêu cầu được trình bày trong phần trước, sử dụng POST thay vì GET

POST trang web của bạn. com/wp-json/wp/v2/posts/535/meta?value=newmetadata

Ví dụ: nếu bạn muốn thêm siêu dữ liệu mà bạn có thể sử dụng để tạo đoạn mã chi tiết cho một công thức, yêu cầu có thể giống như sau

POST trang web của bạn. com/wp-json/wp/v2/posts/535/meta?cookingtime=25

Tùy thuộc vào lượng siêu dữ liệu bạn muốn thêm, thay vào đó, bạn có thể muốn chỉ định siêu dữ liệu đó bằng cách sử dụng các đối tượng JSON, điều này mang lại cách tiếp cận có cấu trúc hơn nhiều. Trong mọi trường hợp, một khi bạn đã quen thuộc với các điểm cuối phổ biến nhất và cách đưa chúng vào sử dụng, cả một thế giới khả năng sẽ mở ra

Thêm điểm cuối vào WordPress

WordPress REST API hỗ trợ các tuyến và điểm cuối tùy chỉnh. Đây là hữu ích nếu bạn muốn tạo một trang web WordPress thứ hai và thêm tích hợp giữa hai.  

Các tuyến trong API REST cũng hỗ trợ các điểm cuối không giới hạn. Bạn có thể chỉ định các phương thức HTTP, hàm gọi lại và quyền, cũng như các giá trị mặc định và một số tham số khác cho từng điểm cuối

Bắt đầu xây dựng trang web WordPress mà bạn hình dung

WordPress REST API đã xuất hiện được vài năm rồi. Nếu bạn chưa bao giờ sử dụng nó trước đây, thì bạn cần phải học rất nhiều để có thể sử dụng nó để phát triển các ứng dụng nâng cao

Tại WP Engine, chúng tôi cung cấp cho bạn tất cả các tài nguyên bạn cần để giúp bạn tìm hiểu càng nhiều càng tốt về phát triển WordPress nói chung, WordPress REST API và cách sử dụng nó. Mặc dù hướng dẫn này cung cấp phần giới thiệu cơ bản, nhưng bạn cũng nên đọc sách điện tử Ultimate WordPress REST API của chúng tôi, cũng như hướng dẫn của chúng tôi dành cho những người không phải là nhà phát triển

API bài đăng WordPress

tham gia 1. 5 triệu trang web tin tưởng WP Engine làm máy chủ lưu trữ WordPress của họ

Xem kế hoạch của chúng tôi

bài viết liên quan

  • Sách điện tử. Phát triển ứng dụng bằng API REST và WordPress
  • API REST của WordPress. Hướng dẫn phi kỹ thuật dành cho những người không phải là nhà phát triển
  • Thúc đẩy kết quả kinh doanh với WordPress REST API
  • Đi sâu về kỹ thuật vào AngularJS và WordPress REST API
  • Hệ thống quản lý nội dung và WordPress không đầu

Đặt mua

Nhận các mẹo, thủ thuật và tin tức WordPress hàng tuần được gửi đến hộp thư đến của bạn

Địa chỉ email

Nộp

Trang web này được bảo vệ bởi reCAPTCHA và áp dụng Chính sách bảo mật và Điều khoản dịch vụ của Google. Tìm hiểu thêm về Chính sách quyền riêng tư của WP Engine

WordPress có thể sử dụng API không?

Đặc biệt, API WordPress REST cho phép bạn kết nối trang web WordPress của mình với các ứng dụng bên ngoài . Điều này có nghĩa là bạn có thể phát triển ứng dụng dành cho thiết bị di động bằng cách sử dụng thực tế bất kỳ ngôn ngữ lập trình nào và sử dụng API WP REST để tìm nạp dữ liệu từ WordPress.

Làm cách nào để tạo bài đăng bằng cách sử dụng API REST?

Ví dụ POST API REST . Bạn cũng cần cung cấp Loại nội dung. tiêu đề yêu cầu application/json và Content-Length. Dưới đây là ví dụ về yêu cầu POST API REST tới điểm cuối ReqBin REST API. make an HTTP POST request and include the POST data in the request's body. You also need to provide the Content-Type: application/json and Content-Length request headers. Below is an example of a REST API POST request to a ReqBin REST API endpoint.

API SOAP và REST là gì?

SOAP là một giao thức, trong khi REST là một kiểu kiến ​​trúc .