Forstå WordPress REST API: En guide for utviklere

Introduksjon

Å opprette et nettsted er en kompleks prosess i flere trinn. Først må du finne en hostingløsning av høy kvalitet. Hvis du skal opprette et nytt nettsted og ikke har et veldig stort ressursbehov eller forventer veldig mye trafikk, er en VPS-server en allsidig løsning som passer for de fleste nettsteder. Hvis betalingsmåten er viktig for deg, bør du vite at du kan velge mellom en rekke alternativer, for eksempel kredittkort-VPS, bitcoin-VPS, AliPay-VPS osv.

Et annet grunnleggende aspekt ved opprettelsen av et nettsted er valget av CMS - content management system, et spesialverktøy som brukes til å fylle nettstedet med innhold og endre det. Hvis du velger WordPress, må utviklerne dine forholde seg til WordPress REST API.

Wordpress er et av de mest populære CMS-systemene for bygging av nettsteder i dag. REST API er på sin side et viktig grensesnitt som brukes til å arbeide med et Wordpress-nettsted. Takket være REST API får applikasjonene dine mulighet til å samhandle med nettstedet ditt via JSON-filer. På denne måten kan utviklere bygge tilpassede applikasjoner, nettsteder og plugins på toppen av Wordpress. Med REST API kan utviklere samhandle med Wordpress-data ved hjelp av HTTP-kommandoer.

I det følgende skal vi ta en titt på noen viktige kommandoer som kan være nyttige for alle utviklere.

WordPress REST API: Grunnleggende

FÅ:

Den brukes til å hente data fra WordPress-databasen ved hjelp av HTTP GET-metoden. Denne kommandoen er en av de vanligste, og er den første kommandoen du bruker før du faktisk gjør noe med dataene dine.

Det gjør det mulig å hente en bestemt ressurs, for eksempel et innlegg, en side eller en egendefinert innleggstype, uten å endre den.

For å bruke metoden må du sende en forespørsel til et bestemt endepunkt med et gitt sett med parametere. Endepunktet presenteres av en URL-adresse for ressursen med parametrene du vil hente - for eksempel ressursens ID, filtreringsalternativer, pagineringsinformasjon og andre spørringsparametere.

Hvis du skriver dette:

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

får du detaljer om innlegget med denne ID-en, for eksempel tittel, innhold, forfatter og andre metadata.

Videre kan du få informasjon om en liste over ressurser. Hvis du for eksempel vil se alle publiserte, bør du legge til /wp/v2/posts?status=publish i forespørselen om endepunkt:

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

POST:

Denne kommandoen brukes til å legge til noe nytt på nettstedet ditt. Dette kan egentlig være et innlegg, men den kan også brukes til sider, kommentarer og andre vedlegg.

Hvis du vil opprette et nytt innlegg, legger du til /wp/v2/posts i endepunktet.

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

I nyttelasten kan du deretter inkludere dataene for det nye innlegget, for eksempel tittel, innhold, forfatter og andre metadata:

"title": "Mitt nye innlegg", "content": "Dette er innholdet i mitt nye innlegg.", "author": 1, "status": "publish"

PUT:

POST brukes til å opprette tomme utkast til sider og innlegg. Hvis du vil oppdatere et utkast med nytt innhold, kan du bruke PUT-kommandoen. Denne kan også brukes til å publisere tidligere opprettede utkast.

Hvis du vil se alle gjeldende utkast, kan du bruke POST-kommandoen på denne måten:

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

Deretter kan du bruke PUT-kommandoen til å endre statusen til en bestemt kladd ved å angi ID-en:

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

Da får du tilgang til innlegget ditt med mulighet til å endre det. Nå må du endre status fra "utkast" til "publiser":

"status" = "publiser"

I tillegg kan du legge til mer innhold ved hjelp av "status"-argumentet:

"status" = "publiser" "innhold" = "innhold her"

SLETT:

En annen viktig kommando som brukes til å slette innlegg, sider, innhold og brukere. Et slettet innlegg legges først i papirkurven.

Hvis du vil slette et bestemt innlegg, for eksempel det som er opprettet ovenfor, skriver du inn noe sånt som dette:

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

Hvis du vil slette innlegget for godt uten å sende det til papirkurven, legger du til ?force=true etter det:

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

MULIGHETER:

Hvis du vil sjekke hvilke kommunikasjonsalternativer som er tilgjengelige for en ressurs, kan du bruke denne kommandoen. Når du skriver inn kommandoen, får du en liste over kommunikasjonsmetoder som er tilgjengelige for en bestemt ressurs, sammen med annen relevant informasjon, som støttede autentiseringsordninger, forespørselshoder og innholdstyper.

HEAD:

Denne kommandoen gjør det mulig å hente innholdets overskrifter uten å måtte forholde seg til selve innholdet. På denne måten kan en utvikler få nødvendig informasjon om deler av innholdet, for eksempel informasjon om hurtigbufring, innholdstype og innholdslengde, uten å måtte laste dem ned.

PATCH:

Med denne kommandoen kan du oppdatere en bestemt del av et innhold. Den ligner litt på PUT, men du trenger ikke å erstatte en bestemt ressurs fullstendig. På denne måten kan du oppdatere tittelen eller innholdet i et innlegg, samt metadata som er knyttet til en bruker, mens resten forblir det samme.

Når du bruker kommandoen, må du spesifisere hvilke endringer du vil utføre. Hvis du for eksempel vil redigere tittelen, må du legge til dette i forespørselen:

"title": "Ny innleggstittel"

Konklusjon

WordPress REST API er et multifunksjonelt grensesnitt som lar applikasjonene dine samhandle med WordPress-nettstedet ditt. Grensesnittet administreres ved hjelp av ulike kommandoer, som vi har viet dagens artikkel til. Vi håper at denne informasjonen var nyttig, takk for at du tok deg tid!