Razumevanje vmesnika WordPress REST API: Vodnik za razvijalce

Uvod

Izdelava spletnega mesta je zapleten in večstopenjski postopek. Za začetek morate najprej poiskati kakovostno rešitev za gostovanje. Če boste ustvarili novo spletno mesto in nimate zelo visokih zahtev po virih ter ne pričakujete zelo velikega prometa, je strežnik VPS vsestranska rešitev, ki bo primerna za večino spletnih mest. Če vam je pomemben način plačila, morate vedeti, da lahko izbirate med različnimi možnostmi, kot so VPS s kreditno kartico, VPS z bitcoini, AliPay VPS itd.

Drugi temeljni vidik ustvarjanja spletne strani je izbira sistema CMS - sistema za upravljanje vsebine, posebnega orodja, ki se uporablja za polnjenje spletne strani z vsebino in njeno spreminjanje. Če ste izbrali WordPress, se bodo morali razvijalci ukvarjati z vmesnikom WordPress REST API.

Wordpress je danes eden izmed najbolj priljubljenih sistemov CMS za izdelavo spletnih strani. API REST pa je bistven vmesnik, ki se uporablja za delo s spletnim mestom Wordpress. Z vmesnikom REST API lahko vaše aplikacije sodelujejo z vašim spletnim mestom prek datotek JSON. Na ta način lahko razvijalci na podlagi Wordpressa gradijo prilagojene aplikacije, spletna mesta in vtičnike. API REST razvijalcem omogoča interakcijo s podatki Wordpressa s pomočjo ukazov HTTP.

V nadaljevanju si bomo ogledali nekaj bistvenih ukazov, ki bodo koristni za vsakega razvijalca.

WordPress REST API: Osnove

GET:

Uporablja se za pridobivanje podatkov iz podatkovne zbirke WordPress z metodo HTTP GET. Ta ukaz je eden najpogostejših, saj je prvi ukaz, ki ga uporabite, preden dejansko nekaj naredite s podatki.

Omogoča pridobitev določenega vira, kot je objava, stran ali tip objave po meri, ne da bi ga spremenili.

Če želite uporabiti metodo, morate določeni končni točki poslati zahtevo z določenim naborom parametrov. Končno točko predstavlja naslov URL vira s parametri, ki jih želite pridobiti - na primer ID vira, možnosti filtriranja, informacije o paginaciji in drugi parametri poizvedbe.

Če to vnesete:

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

boste dobili podrobnosti o objavi s tem posebnim ID, kot so naslov, vsebina, avtor in drugi metapodatki.

Poleg tega lahko dobite informacije o seznamu virov. Če želite na primer videti vse objavljene, morate v zahtevo končne točke dodati /wp/v2/posts?status=publish:

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

POŠTA:

Ta ukaz se uporablja za dodajanje novih elementov na spletno mesto. To je lahko dejansko objava, lahko pa se uporablja tudi za strani, komentarje in druge priloge.

Če želite ustvariti novo objavo, v končno točko dodajte /wp/v2/posts.

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

Nato lahko v koristni tovor vključite podatke za novo objavo, kot so naslov, vsebina, avtor in drugi metapodatki:

"title": "Moja nova objava", "content": "To je vsebina moje nove objave.", "author": 1, "status": "publish".

PUT:

POST se uporablja za ustvarjanje praznih osnutkov za strani in objave. Če ga želite dodatno posodobiti z novo vsebino, lahko uporabite ukaz PUT. Ta ukaz lahko uporabite tudi za objavo predhodno ustvarjenih osnutkov.

Če si želite ogledati vse trenutne osnutke, lahko ukaz POST uporabite na naslednji način:

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

Nato lahko z ukazom PUT spremenite stanje določenega osnutka, tako da vnesete njegov ID:

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

To bo omogočilo dostop do vaše objave z možnostjo, da jo spremenite. Sedaj morate status objave spremeniti iz "osnutek" v "objava":

"status" = "objavi"

Poleg tega mu lahko z argumentom "status" dodate več vsebine:

"status" = "objavi" "content" = "vsebina tukaj"

DELETE:

Še en pomemben ukaz za brisanje objav, strani, vsebine in uporabnikov. Izbrisana objava se najprej odloži v koš.

Če želite izbrisati določeno objavo, na primer zgoraj ustvarjeno, vnesite nekaj takega:

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

Če želite objavo izbrisati za vedno, ne da bi jo poslali v koš, za njo dodajte ?force=true:

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

MOŽNOSTI:

Če želite pri viru preveriti, katere komunikacijske možnosti so mu na voljo, lahko uporabite ta ukaz. Ko vnesete ukaz, boste v izpisu dobili seznam komunikacijskih metod, ki so na voljo za določen vir, skupaj z nekaterimi drugimi pomembnimi informacijami, kot so podprte sheme overjanja, glave zahtevkov in vrste vsebine.

GLAVA:

Ta ukaz omogoča pridobivanje glave vsebine, ne da bi se ukvarjali z dejansko vsebino. Tako lahko razvijalec pridobi potrebne informacije o delih vsebine, kot so informacije o predpomnilniku, vrsti vsebine in dolžini vsebine, ne da bi jih bilo treba prenesti.

POPRAVEK:

S tem ukazom lahko posodobite določen del vsebine. Nekoliko je podoben ukazu PUT, vendar vam ni treba v celoti zamenjati določenega vira. Na ta način lahko posodobite naslov ali vsebino objave ter metapodatke, ki so povezani z uporabnikom, medtem ko ostalo ostane nespremenjeno.

Pri uporabi ukaza morate navesti, katere spremembe želite izvesti. Če želite na primer urediti naslov, morate to dodati v telo zahteve:

"naslov": "Naslov nove objave"

Zaključek

WordPress REST API je večnamenski vmesnik, ki aplikacijam omogoča interakcijo s spletnim mestom WordPress. Vmesnik upravljamo s pomočjo različnih ukazov, ki smo jim posvetili današnji članek. Upamo, da so bile te informacije koristne, in se vam zahvaljujemo za vaš čas!