Bước 1: 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ạn 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 lần gọi.
Bước 2: 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
Chứng thực sẽ được đòi hỏi mỗi lần bạn 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ó thể tìm hiểu thêm những lựa chọn khác được khuyên dùng trong bởi the REST API documentation cho trang chính của bạn.
Bước 3: 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
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/<ID>
Bạn có thể sử dụng nó cho bất kỳ ID nào cho bất kỳ endpoint REST API nào, kể cả bạn muốn hiện một vài viết, trang hoặc taxonomy.
Bước 4: 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.
Hãy thay đổi tiêu đề bài viết., bằng cách gửi yêu cầu 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/<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>
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 sử 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ể!