O introducere în API-ul REST WordPress

Publicat: 2017-01-13

Lansarea WordPress 4.7 a generat multă entuziasm în comunitate și cu un motiv întemeiat. Pe lângă numeroasele îmbunătățiri și caracteristici introduse, adevăratul furor de spectacol a fost anunțul de integrare de bază a API-ului REST. După cum am menționat în postările anterioare, acest lucru transformă în mod eficient WordPress dintr-o platformă de blogging într-un sistem de management al conținutului (CMS). Dar cum va avea loc această transformare? Și care vor fi beneficiile pentru utilizatori?

În acest articol, vă vom prezenta mai întâi câteva dintre conceptele fundamentale și apoi vă vom arăta cum puteți începe să vă jucați cu API-ul și site-ul dvs.

Toate site-urile web ale clienților noștri au fost deja actualizate la WordPress 4.7.1. Deci, să începem!

Ce este un API?

API înseamnă Application Programming Interface . Este un set de structuri documentate conform unui standard de funcționare ca blocuri LEGO pentru dezvoltatorii de software. Aceste structuri pot fi structuri de date, apeluri de funcții, componente de nivel superior, aproape orice. Dezvoltatorii de software folosesc API-uri pentru a construi software mai complex din ele. Ele sunt adesea folosite ca metodă de comunicare între diverse componente software, fie că sunt găzduite local (gândiți-vă la biblioteci de software) sau de la distanță pe Internet, așa cum este cazul API-urilor REST.

Există API-uri pentru multe niveluri diferite de software, de la sistemul de operare la web.

Ce este un API REST?

REST înseamnă REpresentational State Transfer și permite aceeași interoperabilitate și comunicarea componentelor, dar la un nivel superior: Web-ul. Cu REST, puteți avea diverse software-uri bazate pe web scrise în Python, Java sau PHP, comunicând și schimbând date între ele, chiar dacă sunt găzduite în sisteme diferite. Deoarece fiecare sistem știe să „vorbească” REST, poate vorbi cu toți cei care o fac!

REST folosește protocolul HTTP ca transport de comunicații și solicitările HTTP standard pentru a-și implementa operațiunile de bază. Aceste operații se numesc verbe. Cele mai frecvent utilizate sunt: PUT, GET, PATCH, DELETE. Aceste verbe acționează asupra lucrurilor pe care REST le numește Resurse. Sunt implementate de dezvoltatorul de software și implementează eficient toate cele patru operațiuni fundamentale ale computerului care funcționează pe stocare: Creare, Citire, Actualizare, Ștergere ( CRUD ).

Pentru reprezentarea și schimbul de date, REST utilizează o specificație ușoară de date numită JSON ( Javascript Object Notation ). Structura JSON este foarte simplă. Simplitatea și ușurința sa de utilizare, în comparație cu specificațiile de o mie de pagini ale XML și colab., i-au câștigat adoptarea imediată de către dezvoltatori, făcându-l standardul de facto de schimb de date al Web-ului.

Cum îl implementează WordPress?

Deci avem conceptul de verbe (Creare, Read, Update, Delete) care acționează asupra Resurse. WordPress definește ca o resursă REST aproape fiecare element discret de informații care există pe platformă. De la utilizatorii unui site la setări, postări, taxonomii de postare, notificări, media, statistici și tot ce se află între ele. Aceasta include operațiunile care pot fi definite pentru aceste Resurse. De exemplu, operațiunile definite pentru comentarii sunt următoarele:

Obțineți o listă cu comentariile recente.
Obțineți o listă cu comentariile recente la o postare.
Obțineți un singur comentariu.
Editați un comentariu.
Creați un comentariu la o postare.
Creați un comentariu ca răspuns la un alt comentariu.
Ștergeți un comentariu.
Obțineți aprecieri pentru un comentariu.
Like un comentariu.
Eliminați like-ul dintr-un comentariu.
Obțineți statutul de like pentru un comentariu.

Aruncă o privire la pagina oficială de documentație a API-ului pentru WordPress cu ușurință, pentru a obține o idee despre amploarea și profunzimea API-ului și pentru a verifica ce poate face. Posibilitățile sunt atât de multe!

WordPress, astfel, devine o platformă de dezvoltare și un CMS tratând fiecare bit de date care există pe el ca o resursă REST . Le expune pe toate într-un API public, standardizat, permițând părților externe să efectueze operațiuni CRUD asupra lor . În acest fel, WordPress se deschide și devine interoperabil cu restul lumii software, fie că este Java, Python sau Ruby; și aproape cu orice limbă sau sistem care știe să comunice folosind REST.

Încercați-l singur

Există mai multe moduri prin care puteți începe să lucrați cu API-ul REST al site-ului dvs. web. Cel mai ușor de utilizat un plugin de testare REST în browser. Există mai multe în jur, dar cel mai popular este Postman (disponibil pentru MacOSX, Windows și Chrome).

De exemplu, să presupunem că doriți să preluați un obiect JSON care conține toate postările blogului nostru. Pentru a face acest lucru, mai întâi trebuie să consultați Referința oficială WordPress REST, pentru a afla Ruta de bază a apelului de solicitare (este /wp/v2/posts ).

Tot ce trebuie să facem acum este următorul lucru:

Selectați GET din meniul derulant. Există multe verbe REST disponibile, după cum puteți vedea, dar acoperirea acestora nu este scopul acestui articol.
Adăugați traseul de bază ( /wp/v2/posts ) la adresa URL rădăcină REST a site-ului dvs. web (http://www.acme_shop_2.onpressidium.com /wp-json/ ) formând adresa URL pe care o vedeți pe ecran.
Faceți clic pe butonul Trimitere .

Dacă totul merge bine, veți putea vedea răspunsul JSON al site-ului dvs. în fila Corp de dedesubt. Puteți experimenta diferite rute de bază și verbe consultând documentația. API-ul WordPress REST este ceva de care ne vom ocupa în postările viitoare, în care îl vom folosi pe larg, în articole mai orientate spre dezvoltatori.

Viitorul WordPress este luminos!

De-a lungul anilor, WordPress a evoluat foarte mult și a oferit noi posibilități utilizatorilor. Pentru toată lumea, de la bloggeri individuali, jurnaliști, editori la proprietari de afaceri și acum până la dezvoltatori de software din alte comunități open source. WordPress continuă să-și împuternicească utilizatorii. Continuă să ofere un exemplu despre ceea ce pot realiza oamenii atunci când sunt mânați de aceeași pasiune, dar provin din medii diverse. Integrarea sa REST API în nucleul WordPress, nu numai că deschide o nouă lume de posibilități, dar creează și o nouă lume de complexitate . Despre aceasta este soluția noastră de găzduire WordPress gestionată, aceasta este contribuția noastră la comunitate. Este vorba despre a vă permite dvs. și întreprinderea dvs. zilnică . Este vorba despre a lupta împotriva acestei complexități, a menține totul să funcționeze și să fredoneze și să fii acolo, când lucrurile, inevitabil, se vor rupe.