Izpratne par WordPress REST API: Rokasgrāmata izstrādātājiem

Ievads

Tīmekļa vietnes izveide ir sarežģīts un daudzpakāpju process. Lai sāktu, vispirms ir jāatrod kvalitatīvs hostinga risinājums. Ja gatavojaties izveidot jaunu tīmekļa vietni un jums nav ļoti augstas prasības pēc resursiem un nav gaidāma ļoti liela datplūsma, VPS serveris ir universāls risinājums, kas būs piemērots lielākajai daļai tīmekļa vietņu. Ja jums ir svarīga maksājuma metode, jums jāzina, ka varat izvēlēties no dažādām iespējām, piemēram, kredītkaršu VPS, bitcoin VPS, AliPay VPS utt.

Vēl viens būtisks tīmekļa vietnes izveides aspekts ir CMS - satura pārvaldības sistēmas - izvēle, kas ir īpašs rīks, ko izmanto, lai tīmekļa vietni piepildītu ar saturu un to modificētu. Ja jūsu izvēle ir WordPress, izstrādātājiem būs jārēķinās ar WordPress REST API.

Wordpress ir viena no populārākajām tīmekļa vietņu veidošanas CMS mūsdienās. Savukārt REST API ir būtiska saskarne, kas tiek izmantota darbam ar Wordpress tīmekļa vietni. Pateicoties REST API, jūsu lietojumprogrammām ir iespēja mijiedarboties ar jūsu vietni, izmantojot JSON failus. Tādējādi izstrādātāji var veidot pielāgotas lietojumprogrammas, vietnes un spraudņus, izmantojot Wordpress. REST API ļauj izstrādātājiem mijiedarboties ar Wordpress datiem, izmantojot HTTP komandas.

Turpinājumā apskatīsim dažas būtiskas komandas, kas noderēs ikvienam izstrādātājam.

WordPress REST API: Pamati

GET:

To izmanto, lai iegūtu datus no WordPress datubāzes, izmantojot HTTP GET metodi. Šī komanda ir viena no visizplatītākajām komandām, jo tā ir pirmā komanda, ko izmantojat, pirms faktiski kaut ko darāt ar saviem datiem.

Tas ļauj iegūt konkrētu resursu, piemēram, ziņu, lapu vai pielāgotu ziņu tipu, nemainot to.

Lai izmantotu šo metodi, ir jānosūta pieprasījums uz konkrētu galapunktu ar noteiktu parametru kopumu. Galapunkts tiek attēlots kā resursa URL ar parametriem, kurus vēlaties iegūt, piemēram, resursa ID, filtrēšanas opcijas, informāciju par lapas lappusēm un citus vaicājuma parametrus.

Ja ievadāt šo:

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

jūs iegūsiet informāciju par ziņu ar šo konkrēto ID, piemēram, tās nosaukumu, saturu, autoru un citus metadatus.

Turklāt varat iegūt informāciju par resursu sarakstu. Piemēram, ja vēlaties redzēt visus publicētos resursus, galapunkta pieprasījumam jāpievieno /wp/v2/posts?status=publish:

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

POST:

Šo komandu izmanto, lai vietnei pievienotu kaut ko jaunu. Tas faktiski var būt amats, bet to var izmantot arī lapām, komentāriem un citiem pielikumiem.

Lai izveidotu jaunu ziņu, pievienojiet /wp/v2/posts gala punktam.

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

Pēc tam ielādē varēsiet iekļaut jaunā amata datus, piemēram, tā nosaukumu, saturu, autoru un citus metadatus:

"title": "Mans jaunais ieraksts", "content": "Šis ir mana jaunā ieraksta saturs.", "author": 1, "status": "publicēt".

PUT:

POST tiek izmantots, lai izveidotu tukšus lapu un ziņojumu melnrakstus. Lai tālāk atjauninātu vienu no tiem ar jaunu saturu, varat izmantot komandu PUT. To var tālāk izmantot, lai publicētu iepriekš izveidotos melnrakstus.

Lai skatītu visus pašreizējos melnrakstus, varat šādi izmantot POST komandu:

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

Pēc tam varat izmantot komandu PUT, lai mainītu konkrēta melnraksta statusu, ievadot tā ID:

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

Tas ļaus piekļūt jūsu ziņojumam ar iespēju to mainīt. Tagad jums ir jāpārslēdz tā statuss no "melnraksts" uz "publicēt":

"statuss" = "publicēt"

Turklāt, izmantojot argumentu "statuss", varat tam pievienot papildu saturu:

"status" = "publicēt" "content" = "saturs šeit"

DELETE:

Vēl viena būtiska komanda, ko izmanto, lai dzēstu ziņas, lapas, saturu un lietotājus. Izdzēstais ieraksts vispirms tiks ievietots miskastē.

Lai dzēstu konkrētu ziņu, piemēram, iepriekš izveidoto, ievadiet šādu tekstu:

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

Ja vēlaties dzēst ziņu uz visiem laikiem, nenosūtot to uz atkritumu urnu, pievienojiet ?force=true pēc tās:

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

VARIANTI:

Ja vēlaties pārbaudīt resursam pieejamās saziņas opcijas, varat izmantot šo komandu. Ievadot komandu, izejas failā tiks parādīts konkrētajam resursam pieejamo saziņas metožu saraksts kopā ar citu būtisku informāciju, piemēram, atbalstītajām autentifikācijas shēmām, pieprasījuma galvenēm un satura tipiem.

GALVA:

Šī komanda ļauj iegūt satura galvenes, neizmantojot faktisko saturu. Šādā veidā izstrādātājs var iegūt nepieciešamo informāciju par satura daļām, piemēram, informāciju par kešatmiņu, satura tipu un garumu, bez nepieciešamības tās lejupielādēt.

PATCH:

Šī komanda ļauj atjaunināt konkrētu satura daļu. Tā ir nedaudz līdzīga komandai PUT, taču jums nav pilnībā jāaizstāj konkrēts resurss. Šādā veidā varat atjaunināt ieraksta nosaukumu vai saturu, kā arī metadatus, kas ir saistīti ar lietotāju, bet pārējais paliek nemainīgs.

Izmantojot komandu, ir jānorāda, kādas izmaiņas vēlaties veikt. Piemēram, lai rediģētu virsrakstu, jums tas būs jāpievieno pieprasījuma ķermenī:

"title": "Jauna amata nosaukums"

Secinājums

WordPress REST API ir daudzfunkcionāla saskarne, kas ļauj jūsu lietojumprogrammām mijiedarboties ar jūsu WordPress vietni. Šī saskarne tiek pārvaldīta ar dažādu komandu palīdzību, kurām mēs esam veltījuši šodienas rakstu. Ceram, ka šī informācija bija noderīga, paldies par jūsu laiku!