Ce este WordPress REST API și cum îl folosiți?

Probabil ați auzit de REST API. Poate ați auzit că utilizatorii WordPress beneficiază de el. Dar s-ar putea să vă întrebați și ce este exact un API WordPress.

Înțelegerea modului în care funcționează API-urile nu este atât de complicată pe cât pare. Continuați să citiți pentru a afla ce este un API, ce este API-ul REST și cum puteți utiliza API-ul REST WordPress pe site-urile dvs.

Ce este un API?

O interfață de program de aplicație (API) este o modalitate prin care două aplicații „vorbesc” între ele. Un sistem face o cerere, iar celălalt o îndeplinește. Solicitările pe care un sistem le acceptă trebuie incluse în API - altfel cererea nu poate fi îndeplinită.

Gândește-te la asta în acest fel. Poate ți-e foarte foame așa că mergi la Waffle House. Comandați cafea, ouă și clătite. Chelnerița începe să vă noteze comanda - și apoi devine confuză când ajungeți la clătite. Waffle House nu servește clătite. Servesc doar vafe.

Un sistem care solicită clătite dintr-un meniu API care servește doar vafe va fi lăsat de foame.

Ce este API-ul REST?

Când spunem API REST, vorbim despre un sistem de constrângeri conceput pentru internet. Descrie modul în care un site web poate solicita informații de la un alt site într-un mod care este scalabil și uniform. REST înseamnă transfer de stat reprezentativ, care a fost definit de Roy Fielding în teza sa de doctorat.

Ce este API-ul REST WordPress?

WordPress REST API se referă la solicitările făcute către un site web care rulează pe WordPress. Dacă solicităm o listă de postări sau pagini, ne putem aștepta să primim acele informații de la API-ul REST WordPress. WordPress nu va furniza niciodată informații care nu sunt făcute publice, cum ar fi schițele de postări sau (mai important) parolele de utilizator.

Acest lucru este fundamental pentru Editorul de blocuri, care face schimb de date dinamic cu WordPress, fără a reîncărca pagina. Fiecare punct final returnează date într-un format JSON care poate fi citit de JavaScript - sau în acest caz blocuri.

Rețineți că API-ul REST este doar unul dintre API-urile furnizate de WordPress. Există, de asemenea, de exemplu, API-ul pentru baze de date și API-ul Metadate, care sunt folosite de pluginuri pentru a interacționa cu WordPress pe server. Puteți afla mai multe despre API-urile WordPress în Codex.

Cum funcționează o solicitare API REST WordPress?

Există câteva părți de bază ale API-ului REST, și anume: rute, puncte finale, solicitări și răspunsuri.

Trasee

O rută este modul în care facem referire la adresa URL prin care comunică site-ul web. O rută comună în WordPress este „/wp-admin”. Deși nu este o rută a API-ului REST, este o rută folosită de browser pentru a accesa tabloul de bord WordPress Admin. Pentru scopurile noastre, rutele API REST încep cu „/wp-json” (cu JSON fiind formatul standard al datelor).

Puncte finale

Un punct final este combinația dintre o rută și tipul de solicitare de intrare. O singură rută se poate conecta la mai multe puncte finale, deoarece există mai multe tipuri de cereri. Tipurile obișnuite de solicitare includ GET (cum citim datele pe o rută) și POST (cum actualizăm datele pe o rută).

Cereri și răspunsuri

Fiecare comunicare cu API-ul REST este intercalată între o cerere și un răspuns. Un sistem face o cerere la care celălalt sistem răspunde. API-ul REST WordPress include obiecte utile pentru plugin-uri pentru a accesa datele cererii (WP_REST_Request) și a gestiona datele de răspuns (WP_REST_Response) atunci când extind API-ul REST WordPress.

Cum se instalează REST API în WordPress

Începând cu versiunea 4.7 WordPress, WordPress include API-ul REST ca caracteristică de bază.

Dacă rulați o versiune mai veche, puteți instala pluginul pentru funcția json-rest-api. Acesta a fost folosit pentru a dezvolta API-ul REST înainte de a fi integrat complet cu baza de cod WordPress. Acest plugin este închis din punct de vedere tehnic, așa că este recomandat să actualizați versiunea dvs. de WordPress (sau poate luați în considerare Găzduirea WordPress gestionată și veți fi mereu la zi.)

Exemple de API REST WordPress

Aruncă o privire pe site-ul web GiveWP. Dacă accesați blogul lor, veți putea vedea știrile și postările recente. Această rută redă HTML, care este plăcut la vedere, dar cu care un programator este dificil de interacționat. În schimb, postările sunt puse la dispoziția programatorilor folosind ruta „/wp-json/wp/v2/posts”.

Ruta „/wp-json/wp/v2/posts” ne spune că aceasta este o resursă WordPress („/wp”), că aceasta este versiunea 2 (“/v2/”) a resursei și, în special, că acestea sunt postări („/posturi”). Dacă nu ați făcut-o deja, accesați https://givewp.com/wp-json/wp/v2/posts și comparați ceea ce vedeți cu https://givewp.com/blog/. Vă dau un indiciu - este aceeași informație!

Pentru un exemplu de utilizare a API-ului REST în WordPress, luați în considerare cel mai recent bloc de postări. Pentru a obține o listă de postări în WordPress, site-ul ar trebui, în mod tradițional, să facă o solicitare către server și apoi să redea întreaga pagină.

Cel mai recent bloc de postări poate solicita doar postările și apoi se poate reda. Face acest lucru folosind API-ul REST. Și o poate face de mai multe ori pentru a sonda pentru postări noi - fără a reda întreaga pagină. Acest lucru este util mai ales atunci când luați în considerare editarea completă a site-ului în care blocurile sunt folosite pentru a edita și afișa componentele paginii.

Fiecare componentă individuală poate solicita datele de care are nevoie (inclusiv verificarea actualizărilor) și apoi poate reda doar ceea ce s-a schimbat.

Acum știi

Acum că ați înțeles scopul și structura unui API REST WordPress, aruncați o privire pentru a vedea ce puteți găsi pe cont propriu. Pentru o descriere completă despre utilizarea și extinderea API-ului REST WordPress, consultați Manualul API-ului REST.

Amintiți-vă: dacă cineva vă întreabă despre API-uri, nu puteți comanda clătite la Waffle House.

În timp ce vă ajustați site-ul, nu uitați că site-urile grozave au nevoie de găzduire excelentă. Obțineți toate acestea cu WordPress gestionat de Nexcess. Cu viteze puternice, opțiuni de scalabilitate și suport remarcabil, vă puteți baza pe Nexcess pentru a vă alimenta site-ul WordPress.

Vino să vezi de ce este integrat mai bine cu Nexcess. Consultați astăzi planurile noastre de găzduire WordPress gestionate complet.

Resurse WordPress conexe

• WordPress.com vs WordPress.org
• 5 tehnici avansate pentru a vă accelera site-ul WordPress
• Ce este găzduirea WordPress?
• Ghidul esențial al pluginurilor WordPress
• Cum să alegi o gazdă web: ce să cauți și ce să eviți