Înțelegerea API-ului REST WordPress: Un ghid pentru dezvoltatori

Introducere

Crearea unui site web este un proces complex și în mai multe etape. Pentru a începe, trebuie mai întâi să găsiți o soluție de găzduire de calitate pentru acesta. Dacă aveți de gând să creați un site web nou și nu aveți o cerere foarte mare de resurse și nu vă așteptați la un trafic foarte mare, un server VPS este o soluție versatilă care va fi potrivită pentru majoritatea site-urilor web. Dacă metoda de plată contează pentru tine, trebuie să știi că poți alege dintr-o varietate de opțiuni, cum ar fi VPS cu card de credit, VPS cu bitcoin, VPS cu AliPay, etc.

Un alt aspect fundamental al creării unui site web este alegerea unui CMS - sistem de gestionare a conținutului, un instrument special care este folosit pentru a umple site-ul web cu conținut și a-l modifica. Dacă alegerea dvs. este WordPress, dezvoltatorii dvs. vor trebui să aibă de-a face cu WordPress REST API.

Wordpress este unul dintre cele mai populare CMS pentru construirea unui site web în zilele noastre. REST API este, la rândul său, o interfață esențială care este utilizată pentru a lucra cu un site web Wordpress. Datorită REST API, aplicațiile dvs. au posibilitatea de a interacționa cu site-ul dvs. web prin intermediul fișierelor JSON. În acest fel, dezvoltatorii pot construi aplicații, site-uri web și plugin-uri personalizate pe lângă Wordpress. REST API permite dezvoltatorilor să interacționeze cu datele Wordpress prin intermediul comenzilor HTTP.

În cele ce urmează, vom examina câteva comenzi esențiale care vor fi utile pentru orice dezvoltator.

WordPress REST API: Esențial

GET:

Se utilizează pentru a prelua date din baza de date WordPress utilizând metoda HTTP GET. Această comandă este una dintre cele mai comune, fiind prima comandă pe care o folosiți înainte de a face efectiv ceva cu datele dumneavoastră.

Permite recuperarea unei resurse specifice, cum ar fi o postare, o pagină sau un tip de postare personalizat, fără a o modifica.

Pentru a utiliza această metodă, trebuie să trimiteți o cerere către un anumit punct final cu un set de parametri dat. Punctul final este prezentat de o adresă URL a resursei cu parametrii pe care doriți să îi recuperați - de exemplu, ID-ul resursei, opțiunile de filtrare, informațiile de paginare și alți parametri de interogare.

Dacă scrii asta:

GET http://yoursite.com/wp-json/wp/v2/posts/983

veți obține detaliile postării cu acest ID special, cum ar fi titlul, conținutul, autorul și alte metadate.

În plus, puteți obține informații despre o listă de resurse. De exemplu, dacă doriți să le vedeți pe toate cele publicate, ar trebui să adăugați /wp/v2/posts?status=publish la cererea endpoint-ului:

GET http://yoursite.com/wp-json/wp/v2/posts?status=publish

POST:

Această comandă este utilizată pentru a adăuga ceva nou pe site-ul dumneavoastră. Acesta poate fi, de fapt, o postare, dar poate fi folosită și pentru pagini, comentarii și alte atașamente.

Pentru a crea o nouă postare, adăugați /wp/v2/posts la punctul final.

POST http://yoursite.com/wp-json/wp/v2/posts

Apoi, în payload, veți putea include datele pentru noua postare, cum ar fi titlul, conținutul, autorul și alte metadate:

"title": "Noua mea postare", "content": "Acesta este conținutul noii mele postări.", "author": 1, "status": "publish"

PUT:

POST este utilizat pentru a crea proiecte goale pentru pagini și postări. Pentru a actualiza ulterior unul cu conținut nou, puteți utiliza comanda PUT. Aceasta poate fi utilizată în continuare pentru a publica proiectele create anterior.

Pentru a vedea toate proiectele curente, puteți utiliza comanda POST în acest mod:

POST http://yoursite.com/wp-json/wp/v2/posts/?status="draft".

După aceasta, puteți utiliza comanda PUT pentru a modifica starea unui anumit proiect introducând ID-ul acestuia:

PUT http://yoursite.com/wp-json/wp/v2/posts/983

Aceasta va accesa postarea dvs. cu opțiunea de a o modifica. Acum trebuie să îi schimbați statutul din "draft" în "publish":

"status" = "publish"

În plus, puteți adăuga mai mult conținut la acesta folosind argumentul "status":

"status" = "publish" "content" = "content here"

DELETE:

O altă comandă esențială utilizată pentru ștergerea postărilor, paginilor, conținutului și utilizatorilor. O postare ștearsă va fi pusă mai întâi în coșul de gunoi.

Pentru a șterge o anumită postare, de exemplu, cea creată mai sus, introduceți ceva de genul următor:

DELETE http://yoursite.com/wp-json/wp/v2/posts/983

Dacă doriți să ștergeți definitiv mesajul fără să-l trimiteți la coșul de gunoi, adăugați ?force=true după el:

DELETE http://yoursite.com/wp-json/wp/v2/posts/983?force=true

OPȚIUNI:

Dacă doriți să verificați o resursă pentru opțiunile de comunicare disponibile pentru aceasta, puteți utiliza această comandă. Atunci când introduceți comanda, veți obține la ieșire lista de metode de comunicare disponibile pentru o anumită resursă, împreună cu alte informații relevante, cum ar fi schemele de autentificare acceptate, antetele de cerere și tipurile de conținut.

HEAD:

Această comandă permite extragerea antetelor conținutului fără a fi nevoie să se ocupe de conținutul propriu-zis. În acest fel, un dezvoltator poate obține informațiile necesare despre bucăți de conținut, cum ar fi informațiile de cache, tipul și lungimea conținutului, fără a fi nevoie să le descarce.

PATCH:

Această comandă vă permite să actualizați o anumită parte a unui element de conținut. Este oarecum similară cu PUT, dar nu trebuie să înlocuiți complet o anumită resursă. În acest fel, puteți actualiza titlul sau conținutul unei postări, precum și metadatele care sunt asociate unui utilizator, în timp ce restul rămâne neschimbat.

Atunci când utilizați comanda, trebuie să specificați ce modificări doriți să efectuați. De exemplu, pentru a modifica titlul, va trebui să adăugați acest lucru în corpul cererii:

"title": "Titlul noii postări"

Concluzie

WordPress REST API este o interfață multifuncțională care permite aplicațiilor dvs. să interacționeze cu site-ul WordPress. Interfața este gestionată cu ajutorul diferitelor comenzi, cărora le-am dedicat articolul de astăzi. Sperăm că aceste informații v-au fost utile, vă mulțumim pentru timpul acordat!