WordPress APIs: คืออะไรและใช้งานอย่างไร

เผยแพร่แล้ว: 2024-09-13

WordPress JSON REST API สร้างความฮือฮาในชุมชน WordPress โดยนำเสนอความเป็นไปได้ใหม่ๆ สำหรับนักพัฒนาและผู้สร้างเนื้อหา

แม้ว่าอาจฟังดูซับซ้อน แต่การทำความเข้าใจคำศัพท์สำคัญ เช่น JSON, REST และ API สามารถลดความซับซ้อนของการโต้ตอบกับความสามารถที่หลากหลายของ WordPress ได้

API คืออะไร?

API ย่อมาจาก "application programming interface" ซึ่งเป็นชุดคำสั่งและมาตรฐานการเขียนโปรแกรมที่ช่วยให้แอพพลิเคชันซอฟต์แวร์ต่างๆ สามารถสื่อสารระหว่างกันได้

ลองนึกภาพแอปพลิเคชันซอฟต์แวร์ตัวหนึ่งที่บอกทิศทางไปยังอีกแอปพลิเคชันหนึ่ง API คือชุดของกฎที่ตกลงร่วมกันซึ่งควบคุมการโต้ตอบนี้ เมื่อซอฟต์แวร์ชิ้นหนึ่งส่งคำสั่งไปยังอีกชิ้นหนึ่ง API จะอำนวยความสะดวกในการดำเนินการหรือให้ข้อมูลที่จำเป็น

คุณสามารถมอง API ว่าเป็น “อินเทอร์เฟซผู้ใช้” ระหว่างระบบซอฟต์แวร์สองระบบ ซึ่งจัดการการสื่อสารข้อมูลและการดำเนินงาน แต่ผู้ใช้ปลายทางจะมองไม่เห็น

แล็ปท็อปบนโต๊ะไม้

ตัวอย่างของ API

การเข้าถึง API นั้นยอดเยี่ยมมากเมื่อคุณพัฒนาเว็บแอปพลิเคชัน เมื่อมีการเผยแพร่ API สู่สาธารณะ หมายความว่านักพัฒนาได้สร้างโซลูชันที่ขับเคลื่อนโดยบริการของซอฟต์แวร์ บ่อยครั้ง พวกเขาไม่จำเป็นต้องสร้างวงล้อขึ้นมาใหม่สำหรับงานหลายอย่าง เนื่องจากงานเหล่านั้นได้ถูกสร้างขึ้นแล้ว

ตัวอย่างที่ดีของ API คือ Amazon Amazon เปิดตัว API เพื่อให้นักพัฒนาสามารถเข้าถึงผลิตภัณฑ์และข้อมูลได้อย่างง่ายดาย การเข้าถึงสิ่งนี้ทำให้การโพสต์ลิงก์ไปยังผลิตภัณฑ์ใน Amazon เป็นเรื่องง่าย พร้อมราคาที่อัปเดตและตัวเลือกในการซื้อ

อีกตัวอย่างหนึ่งของ API ที่โต้ตอบกันคือการซื้อตั๋วคอนเสิร์ต หากต้องการซื้อตั๋วอย่างเป็นทางการ คุณต้องป้อนข้อมูลบัตรเครดิตของคุณ API ใช้เพื่อส่งข้อมูลบัตรเครดิตของคุณไปยังแอปพลิเคชันระยะไกล ซึ่งจะตรวจสอบว่าข้อมูลบัตรเครดิตถูกต้อง

เมื่อทุกอย่างตรวจสอบเรียบร้อยแล้ว แอปพลิเคชันระยะไกลจะส่งคำตอบกลับไปยังเว็บไซต์ตั๋วโดยแจ้งว่าสามารถดำเนินการต่อได้ ซึ่ง ณ จุดนี้คุณได้ซื้อตั๋วสำเร็จแล้ว เมื่อทั้งหมดนี้เกิดขึ้น คุณจะเห็นเพียงอินเทอร์เฟซเดียวเท่านั้น ซึ่งก็คือเว็บไซต์ตั๋ว เป็นกระบวนการที่ราบรื่น เบื้องหลัง แอปพลิเคชันจำนวนมากทำงานร่วมกันโดยใช้ API แต่คุณในฐานะผู้ใช้จะไม่สังเกตเห็นเมื่อมีการส่งมอบงานจากแอปพลิเคชันหนึ่งไปยังอีกแอปพลิเคชันหนึ่ง

API และ WordPress

การซื้อ Amazon และตั๋วเป็นตัวอย่างที่ดีของการทำงานร่วมกันของ API แต่จะนำไปใช้กับ WordPress ได้อย่างไร

ใช้แนวคิดเดียวกันทั้งหมด ด้วย WordPress API คุณสามารถส่งและดึงข้อมูลเข้าและออกจาก WordPress ได้

API เป็นเครื่องมือสำคัญที่นักพัฒนาสามารถใช้เพื่อแบ่งปันข้อมูลจากเว็บไซต์ WordPress ไปยังเว็บไซต์หรือแอปพลิเคชันอื่น ๆ ได้อย่างง่ายดาย โดยเฉพาะอย่างยิ่ง API นี้ช่วยให้คุณสามารถดำเนิน create read update และ delete (CRUD) บนเนื้อหา WordPress ตัวอย่างบางส่วนของประเภทเนื้อหาได้แก่:

  • กระทู้
  • ประเภทโพสต์ที่กำหนดเอง
  • หน้า
  • อนุกรมวิธาน
  • ผู้ใช้
  • สื่อ

ส่วนที่เหลือหมายถึงอะไร?

ไม่มีการงีบหลับหรือกรนที่นี่ REST หมายถึงรูปแบบสถาปัตยกรรมของ API REST ย่อมาจาก Representational State Transfer

จำที่เราพูดถึงว่า API ให้ข้อมูลเฉพาะสำหรับการสื่อสารเพื่อให้โปรแกรมสามารถสื่อสารระหว่างกันได้หรือไม่ REST API ได้รับการออกแบบในลักษณะที่ให้วิธีการสื่อสารที่ไม่ซับซ้อน ซึ่งช่วยประหยัดแบนด์วิธ WordPress JSON REST API ทำเช่นนี้ ทำให้เป็นตัวเลือกที่ยอดเยี่ยมเมื่อมีข้อมูลปริมาณมาก

เราเพิ่งมีรอยขีดข่วนบนพื้นผิวของ REST; หากคุณต้องการเรียนรู้เพิ่มเติม โปรดดูบทช่วยสอนที่เป็นประโยชน์ของ REST นี้

รูปแบบ JSON

ในการเข้าถึงข้อมูล เราจำเป็นต้องมีแหล่งข้อมูลที่จะดึงออกมา นี่คือที่มาของ JSON JSON ย่อมาจาก JavaScript Object Notation

JSON นั้นง่ายสำหรับทั้งมนุษย์และเครื่องจักรในการอ่านและทำความเข้าใจ เป็นวิธีที่สมบูรณ์แบบในการจัดเก็บข้อมูลในลักษณะที่เป็นระเบียบและเข้าถึงได้ง่าย เนื่องจาก JSON เข้าถึงได้ง่ายมาก จึงเหมาะอย่างยิ่งสำหรับการสร้าง REST API และเป็นโซลูชันที่สมบูรณ์แบบสำหรับ WordPress JSON REST API

ต่อไปนี้เป็นแนวคิดพื้นฐานของรูปแบบ JSON:

[จาวาสคริปต์]
{"พนักงาน":[
{“firstName”:”เจน”, “นามสกุล”:”สมิธ”},
{“firstName”:”แอนนา”, “นามสกุล”:”โอลเซ่น”},
{“ชื่อ”:”จอช”, “นามสกุล”:”โจนส์”}
-

[/จาวาสคริปต์]

รูปแบบ JSON ใน WordPress

JSON ไม่เพียงแต่เขียนเองเท่านั้น แต่อย่ากังวล คุณไม่จำเป็นต้องสร้างไฟล์ JSON ด้วยตนเอง มีปลั๊กอินที่สามารถสร้างให้คุณได้ ด้วยหนึ่งในเครื่องมือเหล่านี้ ข้อมูลของไซต์จะอยู่ในรูปแบบที่ถูกต้อง รวมถึงผู้ใช้ โพสต์ เพจ การจัดหมวดหมู่ และอื่นๆ

การใช้ JSON REST API

การใช้ API ค่อนข้างอธิบายได้ในตัว คุณจะดึงข้อมูลไซต์ของคุณในรูปแบบ JSON แบบธรรมดา และหากคุณติดตั้งปลั๊กอินแล้ว คุณสามารถทดลองดูโพสต์ของเว็บไซต์ของคุณในรูปแบบข้อมูลได้

การดึงหรืออัปเดตข้อมูลทำได้ง่ายเพียงแค่ส่งคำขอ HTTP HTTP เป็นโปรโตคอลคำขอ/ตอบกลับ ขั้นแรก คุณส่งคำขอข้อมูล จากนั้นข้อมูลจะถูกส่งกลับไปเป็นการตอบกลับ

วิธีการรับ

วิธีการ GET ใช้เพื่อดึงข้อมูลและไม่มีผลกระทบต่อข้อมูล เพียงส่งคำขอ GET ไปที่ /wp-json/wp/v2/posts ต้องการค้นหาบางสิ่งบางอย่าง? ตัวอย่างเช่น หากคุณกำลังค้นหา “development” คุณจะได้ผลลัพธ์พร้อมกับคำขอ GET /wp-json/wp/v2/posts?search=development

คำขอโพสต์

คำขอ POST ใช้เพื่อส่งข้อมูล ด้วยความสามารถของ API ใหม่ คุณสามารถอัปเดตผู้ใช้ได้ สมมติว่าคุณต้องการอัพเดตผู้ใช้ด้วย ID 10 สิ่งที่คุณต้องทำคือส่งคำขอ POST ไปที่ /wp-json/wp/v2/users/10

หากต้องการทดลองใช้ เราขอแนะนำให้ใช้บุรุษไปรษณีย์ ซึ่งเป็นส่วนขยายของ Google Chrome

Javascript เพิ่มเติมในการมิกซ์

Backbone.js และ API

Backbone.js เป็นวิธีที่ยอดเยี่ยมในการทำงานกับ API เนื่องจากเป็นเฟรมเวิร์กที่ออกแบบมาเพื่อทำงานกับ REST API WordPress API มี Javascript API ที่ใช้งานง่ายซึ่งอิงตามโมเดล Backbone สิ่งนี้ช่วยให้นักพัฒนาปลั๊กอินและธีมสามารถเริ่มต้นและทำงานได้โดยไม่ต้องใช้ความพยายามและความรู้เชิงลึกเกี่ยวกับรายละเอียดของการเชื่อมต่อ

ยังมีอะไรอีกมากมาย แต่ Backbone ให้โครงสร้างแก่เว็บแอปพลิเคชันโดยจัดเตรียมโมเดล คอลเลกชัน และมุมมอง และเชื่อมต่อทั้งหมดเข้ากับ WordPress API ผ่านอินเทอร์เฟซ REST JSON

โลโก้ตัวอักษร backbone.js

สิ่งนี้หมายความว่าอย่างไรสำหรับนักพัฒนา WordPress?

ด้วยความพร้อมใช้งานของ WordPress API วิธีใหม่ในการใช้งานจึงเพิ่มขึ้นและจะยังคงดำเนินต่อไปเมื่อได้รับความนิยม WordPress API สามารถปรับปรุงฟังก์ชันการทำงานของ WordPress ที่มีอยู่ซึ่งอาศัย Javascript ได้ นี่คือตัวอย่างบางส่วน:

  • การตรวจสอบแบบฟอร์ม/การส่ง
  • ธีมหรือปลั๊กอิน Backbone.js
  • การเลื่อนแบบไม่มีที่สิ้นสุด

นอกจากนี้ยังเป็นวิธีที่ดีในการแสดงเนื้อหาจากแหล่งอื่นอีกด้วย ขณะนี้ การแสดงเนื้อหาจากแต่ละไซต์ภายในการตั้งค่าหลายไซต์เป็นเรื่องง่าย นอกจากนี้ยังสามารถแสดงเนื้อหาจากไซต์ WordPress ที่แยกจากกันโดยสิ้นเชิงได้อีกด้วย นอกจากการแสดงเนื้อหาแล้วยังสามารถอัปเดตเนื้อหาได้ง่ายและมีประสิทธิภาพยิ่งขึ้น


ตอนนี้เราได้พูดถึงคำศัพท์พื้นฐานบางส่วนแล้ว เรารู้ว่า JSON คือสัญลักษณ์ REST คือรูปแบบสถาปัตยกรรม และ API คืออินเทอร์เฟซที่พวกมันสร้างขึ้น การรู้พื้นฐานของ API และความสามารถของ API จะช่วยให้คุณเริ่มต้นได้ดีเมื่อคุณสำรวจความเป็นไปได้ใหม่ๆ ด้วย WordPress API