Bài hướng dẫn WordPress REST API

Quảng cáo
Ads_ngang
Website dinhthuanit.com có bài Bài hướng dẫn WordPress REST API WordPress Rest API bao gồm tất cả những API có thể được thích hợp vào themes, ứng dụng di động và hơn thế nữa. Nói cách khác, nó giúp lập trình viên tách biệt front end khỏi việc quản lý dữ liệu, giúp ứng dụng tương tác với WordPress.

Gần như mọi thứ những dân chuyên WordPress đều đã nghe tới REST API,nhờ vào việc thêm nó vào bản gốc năm 2015. Tuy nhiên, hầu hết các tình huống chỉ những lập trình viên chuyên sâu mới nghiên cứu sâu về tính năng nay hùng cường này.

WordPress Rest API kể cả tất cả các API có thể được thích hợp vào themes, ứng dụng di động và hơn thế nữa. Nói cách khác, nó giúp lập trình viên cách ly front end khỏi việc quản lý dữ liệu, giúp ứng dụng tương tác với WordPress. Học cách sử dụng công cụ này là mở ra cách cửa vô tận khả năng để mở rộng WordPress website của bạn.

Trong bài chỉ dẫn này, chúng tôi sẽ giới thiệuc ho bạn biết về dự án WordPress Rest API, lý giải vì sao nó là một ý tưởng lớn, và chỉ một số cách ứng dụng. Hãy bắt đầu nhanh thôi nào!

Giới thiệu WordPress REST API

WP REST API project homepage

WordPress Representational State Transfer (REST) API dự án là Bước tiến của WordPress trong việc trở thành một nền tảng ứng dụng chính thức.  Sự hiện diện của REST API trong lõi WordPress là minh chứng cho việc này.

Dự án được upload đầu tiên lên GitHub for development tháng Sáu 2013 bởi Ryan McCue và Rachel Baker. Plugin độc lập REST API được tích hợp vào WordPress core tháng 9 năm 2015, sau khi thu được rất nhiều sự ủng hộ từ cộng đồng và thu hút hơn 100 người góp sức vào việc hoàn thiện khả năng cho nó.

Từ khi ra mắt trong WordPress core, REST API đã có biết bao người dùng. Đây là cách để cải tiến dự án của bạn, được truyền cảm hứng bởi những tình huống cụ thể trên ngoài nước như sau:

  1. Event Espresso sử dụng REST API để cung cấp cho lập trình viên khả năng truy cập vào hạ tầng nội bộ, làm cho việc phát triển app dựa trên dịch vụ của họ đơn giản hơn
  2. Simmer giúp lập trình viên truy cập vào API để mở rộng tính năng hóa đơn thành một phần mềm chính thức hoặc tùy chỉnh themes.
  3. JoinIn tăng sức mạnh cho  widget ’embeddable’ bằng REST API, khiến nó phổ biến bởi những luồng dữ liệu phù hợp bất kỳ lúc nào nó hiển thị.

Đây chỉ là bề nổi của tảng băng mà những ý tưởng sáng tạo hơn cũng đều có thể dùng với REST API. Tuy nhiên hãy tìm biết thêm cách REST API hoạt động.

Cách hoạt động của WordPress Rest API

Nói ngắn gọn, REST API hoạt động bằng cách xử lý dữ liệu từ ở một địa điểm tới chỗ khác mà không truy cập trực diện vào database hoặc giao diện người dùng. Có nhiều loại Application Programming Interfaces (APIs), nhưng REST nổi bật vì là một chuẩn hiện đại.

REST APIs được đem ra ở Hyper Text Transfer Protocol (HTTP), sử dụng cấu trúc JavaScript Object Notation (JSON). Nhưng kỹ thuật này cho phép API sử dụng địa điểm web duy nhất để đưa dữ liệu thực thi như là JavaScript objects.

Nếu bạn chưa bao giờ làm việc với JavaScripts hoặc object notation trước đây, có thể bắt đầu bằng sự việc học cơ bản về JSON. Khi đã quyen với ý tưởng của REST API, hãy tìm hiểu về những ảnh hưởng lớn nó giành cho lâp trình viên WordPress.

Vì sao WordPress REST API có ảnh hưởng tới lập trình viên

WordPress REST API Handbook

WordPress REST API là một kết nối mở từ bất kỳ WordPress nào tới bất kỳ phần mềm nào trên web server hoặc hệ điều hành nào. Có nghĩa là bạn chỉ bị giới hạn bởi khả năng mường tượng của mình trong việc việc tận dụng WordPress. Bạn cũng có thể dựng bất kỳ phần mềm nào, lập trình bất kỳ nền tảng hoặc ngôn ngữ nào, sử dụng WordPress để xử lý dữ liệu qua REST API. Ứng dụng thật tế cực kỳ lớn, vì WordPress có cộng đồng sử dụng rất đông và mở.

Hơn nữa, vì REST API dựa trên JavaScript, việc tập trùng vào API đánh dấu bước chuyển về ngôn ngữ lập trình nào quan trọng để học. Bạn cũng có thể JavaScript nền server là một PHP mới. Việc này có thể thấy được trong phần mềm mới của WordPress.com, Calypso, vận hành hoàn toàn trên JavaScript và REST API.

Bằng cách chuẩn hóa ứng dụng (gồm WordPress’ core) tương tác với dữ liệu WordPress, quá trình phát triển WordPress sẽ dễ dàng hơn và mượt mà hơn. Còn nữa, nó sẽ dễ tương thích với nền tảng thứ 3 hơn.

Tuy nhiên, công đoạn chuyển đổi cũng đều có thể hơi khó khăn, đó là nguyên nhân vì sao rất quan trọng để học cách sử dụng công nghệ này bây giờ. Đã đến lúc học bước đầu sử dụng REST API để  áp dụng cho dự án của bạn rồi đấy!

 

5 Bước để bắt đầu với WordPress REST API

Như đã nói phía trên REST API có thể được sử dụng với bất kỳ ứng dụng hay ngôn ngữ lập trình nào để gọi một HTTP endpoint (gần như là tất cả). Vì vậy, chúng ta sẽ tập trung sử dụng command line để thực thi REST API requests, vì nó là cách đơn giản nhất và ít lỗi lập trình nhất mà có thể xảy ra trong qui trình học.

Để làm vậy, bạn sẽ cần mở Command Line Interface (CLI) trên máy tính của bạn –  Terminal trên macOS hay Linux, và Command Prompt trên Windows. CLI cấp phép bạn trực diện tương tác với REST API, mà không phải viết thêm scripts để yêu và xử lý thông tin. Bất kỳ request nào được thực hiển thị trên CLI có thể được scripts thành PHP, JavaScript, và ngôn ngữ khác nhưng mỗi phương thức sẽ khác nhau. Ra lệnh trong CLI là dễ dàng và rõ ràng. Chỉ cần gõ command bạn cần vàn hấn ENTER trên bàn phím.

Chúng tôi cũng khuyên tạo một site demo trên máy tính, thay vì hoàn tất bài chỉ dẫn này trên site chạy thật. Cuối cùng, bạn chỉ cần tạo site WordPress bản 4.4 trở lên là được. Khi đã sẳn sàng, hãy bắt đầu học thôi!

Bước 1: Làm quen với các khái niệm chính của REST API

Trước khi bắt đầu, hãy làm quen với mọi thứ REST APIs trước lúc tiếp tục. Có 5 khái niệm chính và thuật ngữ bạn phải nắm rõ. Hãy nhìn qua chúng:

  1. ‘Routes’ và ‘Endpoints’. Đây là phần quan trọng nhất của REST API cần. Route giúp bạn di chuyển qua endpoints, khi mà một phương thức HTTP nhất định (ví dụ: một dataset tĩnh hoặc một action) kết nối tới một route nhất định. Ví dụ,  /wp-json/ là route được thiết kế như là một endpoint để cho chúng ta thấy các route khả dụng.
  2. Requests. Được tạo ra để kích hoạt đúng endpoints và chuyển dữ liệu đi.
  3. Responses. Cung cấp dữ liệu được đòi hỏi hoặc trả về lỗi để bạn biết có gì đó không đúng.
  4. Schemas. Những mẫu responses, để bạn luôn biết chính xác nơi nào cần tìm cho ra đúng dữ liệu.
  5. Controller classes. Trong điều kiện của layman, họ cấp phép dựng route và endpoint riêng. Bây giờ, bạn không càng phải nghĩ tới những điều này, mặc dù cũng đều có thể chúng sẽ hữu dụng sau này.

Khi bạn đã hiểu 5 khái niệm trên, bạn có thể bắt đầu đào sâu vào REST API, bắt đầu với endpoints.

Bước 2: Tìm hiểu về những Endpoints REST API hữu dụng nhất

WordPress REST API cho bạn một sách mẫu gồm tất cả những endpoints hữu dụng. Trước tiên, bạn nên biết cấu trúc làm thế nào một HTTP gọi tới một REST API. Cơ bản mỗi lần WordPress REST API gọi như sau, (thay thế yourdomain.com thành tên miền của bạn):

 http://yourdomain.com/wp-json/ 

Bạn cũng có thể có thể thử kết nối bằng phương pháp thực thi lệnh curl trong CLI bằng URL của riêng bạn:

 curl -X OPTIONS -i http://yourdomain.com/wp-json/ 

Bạn sẽ được chào bằng một thông báo HTTP thành công. Sau đó bạn cũng có thể có thể tiếp tục và lặp lại câu lệnh này với các endpoints chính. Lần này, chúng ta sẽ dùng Get của curl.

Để lấy bản kê JSON của 1 post WordPress, bạn cũng có thể dùng  lệnh sau:

 curl -X GET -i http://yourdomain.com/wp-json/wp/v2/posts 

Ngoài ra, hãy thử kiểm tra những trang đang hiện diện của WordPress:

 curl -X GET -i http://yourdomain.com/wp-json/wp/v2/pages 
Bạn cũng có thể nghiệm với mỗi endpoints sau (và nhiều hơn nữa!)trong CLI để xem các kết quả trả về mỗi đợt gọi.

Bước 3: Học cách chứng nhận API cơ bản của REST API

Đã đến lúc tìm hiểu về cách xác thực. Một số actions và data trong REST API là public, nhưng những phần khác cần đăng nhập dưới dạng administrator. Tuy nhiên, với REST API, không có cách để đăng nhập. Ngoài trừ việc bạn chứng thực bạn trước lúc gọi mỗi câu lệnh cần quyền admin, như là hiển thị những nội dung chưa public hoặc cập nhật bài post.

Bằng cách cài đặt plugin WordPress REST API Basic Auth.Đây là plugin thử nghiệm để học về REST API nhanh chóng, nó không được sử dụng cho những site đã vận hành.  Tuy nhiên, công đoạn cài đặt cũng như các plugin khác.

Khi Basic Auth đã được cài đặt, bạn cũng có thể chứng nhận qua CLI với cờ user. Đây là thí dụ thế nào để áp dụng chứng thực cho user, bằng phương pháp dùng curl để hiển thị các bài viết không được xuất bản.:

 curl -X GET --user username:password -i http://yourdomain.com/wp-json/wp/v2/posts?status=draft 
Chứng thực sẽ được đòi hỏi mỗi đợt bạn mong muốn hiển thị những thông tin không được công khai. Khi bạn đã biết về việc xác thực, bạn cũng có thể có thể tìm hiểu thêm những chọn lựa khác được khuyên dùng trong bởi the REST API documentation cho trang chính của bạn.

Bước 4: Chọn bài viết trước mắt của bạn với REST API

Khi bạn đã hiểu làm ra sao để tạo một call cơ bản tới REST API sử dụng curl, hãy thử chọn một bài viết. Đầu tiên, liệt kê tất cả bài viết như là bạn đã làm trước đây:

 curl -X GET -i http://yourdomain.com/wp-json/wp/v2/posts 
 Tiếp theo, tìm ID của bài post bạn muốn cập nhật. Bạn sẽ thêm ID này vào cuối query để chọn chỉ bài viết đó:
 curl -X GET -i http://yourdomain.com/wp-json/wp/v2/posts/ 

 Bạn có thể sử dụng nó cho bất kỳ ID nào cho bất kỳ endpoint REST API nào, cho dù là bạn mong muốn hiện một vài viết, trang hoặc taxonomy.

Bước 5: Cập nhật bài viết WordPress với REST API

Cuối cùng, hãy thử cập nhật bài viết. Thay vì sử dụng lệnh OPTION và GET, lần này chúng ta sẽ dùng  POST  để thay đổi.  GET  được dùng để đọc dữ liệu, POST được sử dụng để gửi nó đi.

Hãy thay đổi tiêu đề bài viết., bằng phương pháp gửi đòi hỏi POST với chứng thực. Thay đổi sẽ được chia sẽ bằng cách sử dụng cờ d tại cuối mỗi lệnh. Bạn sẽ chuyển một đối tượng JavaScript với biết title thành một giá trị khác, như là My New Title, như lệnh bên dưới:

 curl -X POST --user username:password http://yourdomain.com/wp-json/wp/v2/posts/   -d '{"title":"My New Title"}'   
 Hãy chắc bạn đã thay thế username password, post ID và tiêu đề với đúng thông tin của bạn. Bạn có thể chọn lại mỗi bài viết để xác thực thay đổi.
 curl -X GET -i http://yourdomain.com/wp-json/wp/v2/posts/ 

 Chúc mừng! Bạn đã thay đổi thành công lần đầu tiên với quyền quản trị bằng cách dùng WordPress REST API. Tất nhiên, bài hướng dẫn cơ bản này khó có thể nói lên REST API có thể làm gì, nhưng điểm chính là nắm cơ bản vì mọi sự mở rộng đều có thể!

Lời kết

WordPress REST API là phần nào mạnh mẽ của lõi WordPress, một số lập trình viên đã tìm hiểu kỹ về khả năng của nó. Kết quả nếu bạn bắt đầu tìm hiểu sớm và học việc làm việc với nó cũng có thể có thể khiến bạn trở thành một lập trình có nhiều lợi thế hơn, và giúp bạn tạo những phần mềm sử dụng WordPress làm framework.

Để tổng kết, này là năm bước trước mắt cần học để tương tác với WordPress REST API:

  1. Làm quen khái niệm của REST API.
  2. Tìm hiểu những REST API endpoints hữu dụng nhất.
  3. Học cách cơ bản của chứng nhận qua REST API .
  4. Chọn bài post đầu tiên của WordPress REST API.
  5. Cập nhật bài viết WordPress với REST API.

Bạn có điều gì muốn hỏi về WordPress REST API không? Hãy cho chúng tôi biết bằng phương pháp để lại bình luận bên dưới!

Từ khóa bài viết: dinhthuanit.com,

Bài viết Bài hướng dẫn WordPress REST API được tổng hợp và biên tập bởi: dinhthuanit.com. Mọi ý kiến đóng góp và phản hồi vui lòng gửi Liên Hệ cho dinhthuanit.com để điều chỉnh. dinhthuanit.com xin cảm ơn.

Bài Viết Liên Quan


Bài Viết Khác


Quảng cáo
Ads_ngang