API-urile WordPress: Ce sunt și cum să le folosiți

API-ul WordPress JSON REST a creat destul de multă popularitate în comunitatea WordPress, oferind noi posibilități atât pentru dezvoltatori, cât și pentru creatorii de conținut.

Deși poate părea complex, înțelegerea termenilor cheie precum JSON, REST și API poate simplifica modul în care interacționați cu capabilitățile ample ale WordPress.

Ce este un API?

API înseamnă „interfață de programare a aplicațiilor”, care este în esență un set de instrucțiuni de programare și standarde care permit diferitelor aplicații software să comunice între ele.

Imaginați-vă că o aplicație software dă instrucțiuni către alta — un API este un set de reguli convenite care guvernează această interacțiune. Când un program trimite instrucțiuni altuia, API-ul facilitează acțiunea sau oferă informațiile necesare.

Vă puteți gândi la un API ca la „interfața cu utilizatorul” între două sisteme software, care gestionează comunicarea datelor și executarea sarcinilor, dar invizibilă pentru utilizatorul final.

Exemple de API-uri

A avea acces la un API este minunat atunci când dezvoltați aplicații web. Când un API este lansat pentru public, înseamnă că dezvoltatorii au creat soluții care sunt alimentate de serviciul software. De multe ori, ele elimină nevoia de a reinventa roata pentru multe sarcini, deoarece acestea au fost deja create.

Un exemplu excelent de API este Amazon. Amazon și-a lansat API-ul, astfel încât dezvoltatorii să poată accesa cu ușurință produsele și informațiile acestora. Având acces la aceasta, este ușor să postați link-uri către produse pe Amazon, cu prețuri actualizate și opțiunea de cumpărare.

Un alt exemplu de interacțiune a API-urilor ar fi achiziționarea de bilete la concert. Pentru a cumpăra oficial bilete, trebuie să introduceți informațiile cardului dvs. de credit. Un API este utilizat pentru a trimite informațiile cardului de credit către o aplicație de la distanță, care apoi verifică dacă informațiile cardului de credit sunt corecte.

Odată ce totul este verificat, aplicația de la distanță trimite un răspuns înapoi către site-ul web de bilete, spunând că este în regulă să continuați, moment în care ați achiziționat cu succes biletele. Când toate acestea se întâmplă, vedeți o singură interfață, care este site-ul web de bilete. Este un proces fără întreruperi; în culise, multe aplicații lucrează împreună folosind API-uri, dar tu, ca utilizator, nu observi când sarcinile sunt transmise de la o aplicație la alta.

API-uri și WordPress

Amazon și achizițiile de bilete sunt exemple grozave ale modului în care API-urile funcționează împreună, dar cum se aplică acest lucru WordPress?

Ei bine, toate aceleași idei se aplică. Cu API-ul WordPress, puteți împinge și extrage date în și din WordPress.

API-ul este un instrument cheie pe care dezvoltatorii îl pot folosi pentru a partaja cu ușurință datele de pe site-ul lor WordPress către alte site-uri web sau aplicații. Mai exact, acest API vă permite să efectuați acțiuni create , read , update și delete (CRUD) pe conținutul WordPress. Câteva exemple de tipuri de conținut sunt:

• Postări
• Tipuri de postări personalizate
• Pagini
• Taxonomii
• Utilizatori
• Media

Ce înseamnă REST?

Aici nu există somn sau sforăit – REST se referă la stilul arhitectural al unui API. REST înseamnă Transfer de stat reprezentativ.

Vă amintiți cum am menționat că un API oferă specificul pentru comunicare, astfel încât programele să poată comunica între ele? API-urile REST sunt proiectate astfel încât să ofere o metodă ușoară de comunicare, care economisește lățime de bandă. API-ul WordPress JSON REST face exact acest lucru, făcându-l o opțiune excelentă atunci când există un volum mare de date.

Tocmai am zgâriat suprafața REST; dacă doriți să aflați mai multe, consultați acest tutorial util REST.

format JSON

Pentru a accesa date, avem nevoie de o sursă din care să extragem. Aici intervine JSON. JSON înseamnă JavaScript Object Notation.

JSON este ușor de citit și de înțeles atât pentru oameni, cât și pentru mașini. Este modalitatea perfectă de a stoca informații într-un mod organizat, ușor de accesat. Deoarece JSON este atât de simplu de accesat, acest lucru îl face potrivit pentru crearea API-urilor REST și este soluția perfectă pentru API-ul REST JSON WordPress.

Iată o idee de bază despre cum arată formatul JSON:

[javascript]
{„angajați”:[
{“firstName”:”Jane”, “lastName”:”Smith”},
{“firstName”:”Anna”, “lastName”:”Olsen”},
{“firstName”:”Josh”, “lastName”:”Jones”}
]}

[/javascript]

Format JSON în WordPress

JSON nu se scrie doar de la sine, dar nu vă faceți griji, nu trebuie să creați manual fișierul JSON. Există pluginuri care îl pot crea pentru tine. Cu unul dintre aceste instrumente, datele site-ului vor fi în formatul corect, inclusiv utilizatori, postări, pagini, taxonomii și multe altele.

Folosind API-ul JSON REST

Utilizarea API-ului este destul de explicită; veți prelua datele site-ului dvs. în format JSON simplu. Și dacă aveți un plugin instalat, vă puteți juca cu vizualizarea postărilor site-ului dvs. sub formă de date.

Preluarea sau actualizarea datelor este la fel de simplă ca și trimiterea unei cereri HTTP. HTTP este un protocol de cerere/răspuns. Mai întâi, trimiteți o solicitare de date și apoi datele sunt trimise înapoi ca răspuns.

metoda GET

Metoda GET este folosită pentru a prelua informații și nu are niciun efect asupra datelor. Pur și simplu trimiteți o solicitare GET la /wp-json/wp/v2/posts . Vrei să cauți ceva? De exemplu, dacă căutați „dezvoltare”, veți obține rezultatele cu cererea GET /wp-json/wp/v2/posts?search=development .

Solicitare POST

O solicitare POST este folosită pentru a trimite date. Cu capabilitățile noului API, de exemplu, puteți actualiza un utilizator. Să presupunem că doriți să actualizați utilizatorul cu ID-ul 10. Tot ce trebuie să faceți este să trimiteți o solicitare POST către /wp-json/wp/v2/users/10 .

Pentru a încerca acest lucru, vă recomandăm să utilizați Postman, o extensie Google Chrome.

Mai mult Javascript în amestec

Backbone.js și API-uri

Backbone.js este o modalitate excelentă de a lucra cu API-ul, deoarece este un cadru conceput pentru a lucra cu API-urile REST. API-ul WordPress include un API Javascript ușor de utilizat, bazat pe modele Backbone. Acest lucru permite dezvoltatorilor de pluginuri și teme să se înceapă și să ruleze fără efort și cunoștințe foarte aprofundate despre detaliile conectării.

Există mult mai mult, dar Backbone oferă structură aplicațiilor web prin furnizarea de modele, colecții și vizualizări și conectează totul la API-ul WordPress printr-o interfață REST JSON.

Ce înseamnă asta pentru dezvoltatorii WordPress?

Odată cu disponibilitatea API-ului WordPress, noi modalități de utilizare au crescut și vor continua să o facă pe măsură ce câștigă popularitate. API-ul WordPress poate îmbunătăți aproape orice funcționalitate WordPress existentă care se bazează pe Javascript. Iată câteva exemple:

• validarea/depunerea formularului
• Teme sau pluginuri Backbone.js
• defilare infinită

Este, de asemenea, o modalitate excelentă de a afișa conținut din alte surse. Acum, este ușor să afișați conținut de pe un site individual în cadrul unei configurații multisite. De asemenea, este posibil să afișați conținut de pe un site WordPress complet separat. Pe lângă afișarea conținutului, conținutul poate fi, de asemenea, actualizat mai ușor și mai eficient.

Acum că am trecut peste o parte din terminologia de bază, știm că JSON este notația, REST este stilul arhitectural și API este interfața pe care o formează. Cunoașterea elementelor de bază ale API-ului și capacitățile sale vă va asigura că aveți un început bun atunci când explorați noile posibilități cu API-ul WordPress.