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

https://www.hostinger.vn/huong-dan/bai-huong-dan-wordpress-rest-api/

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

Như đã nói ở trên REST API có thể được 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 dễ nhất và ít lỗi lập trình nhất mà có thể xảy ra trong quá 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 cho phép bạn trực tiếp 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 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à đơn giản 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 hướng 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 những khái niệm chính của REST API

Trước khi bắt đầu, hãy làm quen với tất cả REST APIs trước khi tiếp tục. Có 5 khái niệm chính và thuật ngữ bạn cần nắm rõ. Hãy xem 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 yêu cầu 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ọ cho phép dựng route và endpoint riêng. Bây giờ, bạn không cần phải nghĩ tới những điều này, mặc dù 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 cầ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ó thể thử kết nối bằng cách 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ó 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 danh sách JSON của một post WordPress, bạn 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 tồn tại của WordPress:

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

Bước 3: Học cách chứng thực 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 khi 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 dùng cho những site đã vận hành. Tuy nhiên, quá trình cài đặt cũng như các plugin khác.

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

curl -X GET --user username:password -i http://yourdomain.com/wp-json/wp/v2/posts?status=draft

Bước 4: Chọn bài viết đầu tiên của bạn với REST API

Khi bạn đã hiểu làm thế nào để 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
curl -X GET -i http://yourdomain.com/wp-json/wp/v2/posts/<ID>

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 dùng để gửi nó đi.

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/<ID> -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/<ID>

Last updated