Este posibil să fi auzit zgomotul despre API-ul WordPress JSON REST. Aceasta este o veste mare pentru utilizatorii WordPress și motiv de sărbătoare!

JSON, REST, API – totuși, acesta este mult jargon pentru un singur nume, așa că haideți să dezvăluim totul.

Ce este un API?

API înseamnă „interfață de programare a aplicațiilor”, care este un set de instrucțiuni de programare și standarde pentru accesarea unei aplicații software bazate pe web sau a unui instrument web. Imaginați-vă „software one” care dă instrucțiuni „software doi”. Un API este un acord între cei doi și liniile de comunicare sunt deschise. Practic, ceea ce își spun unul altuia este ceva de genul „când îmi dați o instrucțiune, voi efectua acțiunea sau voi returna informațiile corecte”.

Pe măsură ce căutăm pe web și folosim diverse soluții software, suntem obișnuiți cu interfețele de utilizator cu anumite aspecte, butoane și grafice cu care interacționăm pentru a finaliza sarcinile dorite. Toate acestea sunt inutile pentru o mașină, deoarece tot ce le pasă sunt date și ce trebuie să facă și cum interacționează cu acestea. Un API este alternativa software-ului la „interfața cu utilizatorul”, oferind instrucțiuni unui al doilea software despre cum să obțineți date și alte sarcini specifice. Ele sunt complet invizibile pentru utilizatorii care folosesc aplicația web și sunt pur și simplu o interfață software-la-software.

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 grozav de API este Amazon. Amazon și-a lansat API-ul, astfel încât dezvoltatorii să poată avea acces ușor la produse ș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 ș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 să împingeți și să extrageți date din WordPress.

API-ul este un instrument cheie pe care dezvoltatorii îl pot folosi pentru a partaja cu ușurință date 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 de 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
• Mass-media

Ce înseamnă REST?

Aici nu există somn sau sforăit, dar 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:

{"employees":[
	{"firstName":"Jane", "lastName":"Smith"},
	{"firstName":"Anna", "lastName":"Olsen"},
	{"firstName":"Josh", "lastName":"Jones"}
]}

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ă un plugin grozav care îl creează pentru tine. Cu acest instrument, datele site-ului vor fi în formatul corect, inclusiv utilizatori, postări, pagini, taxonomii și multe altele. Pluginul poate fi găsit aici. De asemenea, există o documentație utilă care va fi valoroasă atunci când începeți.

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 pluginul 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, aș recomanda 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ă toate acestea 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:

• validare/depunere formular
• 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 și actualizat.

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.