Förstå WordPress REST API: En guide för utvecklare

Introduktion

Att skapa en webbplats är en komplex process i flera steg. Till att börja med måste du hitta en bra hostinglösning för den. Om du ska skapa en ny webbplats och inte har en mycket hög efterfrågan på resurser och mycket hög trafik förväntas, en VPS-server är en mångsidig lösning som kommer att vara lämplig för de flesta webbplatser. Om betalningsmetoden är viktig för dig bör du veta att du kan välja mellan en mängd olika alternativ, till exempel VPS med kreditkort, VPS med bitcoin, VPS med AliPay osv.

En annan grundläggande aspekt av att skapa en webbplats är valet av CMS - content management system, ett specialverktyg som används för att fylla webbplatsen med innehåll och ändra det. Om du väljer WordPress kommer dina utvecklare att behöva hantera WordPress REST API.

Wordpress är ett av de mest populära CMS för att bygga en webbplats idag. REST API är i sin tur ett viktigt gränssnitt som används för att arbeta med en Wordpress-webbplats. Tack vare REST API får dina applikationer möjlighet att interagera med din webbplats via JSON-filer. På så sätt kan utvecklare bygga anpassade applikationer, webbplatser och plugins ovanpå Wordpress. Med REST API kan utvecklare interagera med Wordpress-data med hjälp av HTTP-kommandon.

I det följande kommer vi att ta en titt på några viktiga kommandon som kan vara användbara för alla utvecklare.

WordPress REST API: Grundläggande

GET:

Det används för att hämta data från WordPress-databasen med hjälp av HTTP GET-metoden. Detta kommando är ett av de vanligaste och är det första kommandot du använder innan du faktiskt gör något med dina data.

Det gör det möjligt att hämta en specifik resurs, t.ex. ett inlägg, en sida eller en anpassad inläggstyp, utan att modifiera den.

För att använda metoden måste du skicka en begäran till en specifik slutpunkt med en given uppsättning parametrar. Slutpunkten presenteras av en URL för resursen med de parametrar som du vill hämta - till exempel resursens ID, filtreringsalternativ, pagineringsinformation och andra frågeparametrar.

Om du skriver detta:

HÄMTA http://yoursite.com/wp-json/wp/v2/posts/983

får du information om inlägget med detta specifika ID, t.ex. titel, innehåll, författare och andra metadata.

Dessutom kan du få information om en lista över resurser. Om du till exempel vill se alla publicerade inlägg bör du lägga till /wp/v2/posts?status=publish i endpoint-förfrågan:

HÄMTA http://yoursite.com/wp-json/wp/v2/posts?status=publish

POST:

Detta kommando används för att lägga till något nytt på din webbplats. Detta kan egentligen vara ett inlägg, men det kan också användas för sidor, kommentarer och andra bilagor.

För att skapa ett nytt inlägg, lägg till /wp/v2/posts till ändpunkten.

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

I nyttolasten kan du sedan inkludera data för det nya inlägget, t.ex. titel, innehåll, författare och andra metadata:

"title": "Mitt nya inlägg", "content": "Detta är innehållet i mitt nya inlägg.", "author": 1, "status": "publicera"

PUT:

POST används för att skapa tomma utkast för sidor och inlägg. För att uppdatera ett utkast med nytt innehåll kan du använda kommandot PUT. Detta kan även användas för att publicera tidigare skapade utkast.

För att se alla aktuella utkast kan du använda POST-kommandot på följande sätt:

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

Efter detta kan du använda kommandot PUT för att ändra status för ett visst utkast genom att ange dess ID:

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

Detta ger tillgång till ditt inlägg med möjlighet att ändra det. Nu måste du ändra status från "utkast" till "publicera":

"status" = "publicera"

Dessutom kan du lägga till mer innehåll med hjälp av "status"-argumentet:

"status" = "publicera" "innehåll" = "innehåll här"

DELETE:

Ett annat viktigt kommando som används för att radera inlägg, sidor, innehåll och användare. Ett raderat inlägg läggs först i papperskorgen.

För att radera ett visst inlägg, t.ex. det som skapats ovan, anger du något i stil med detta:

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

Om du vill radera inlägget för gott utan att skicka det till papperskorgen, lägg till ?force=true efter det:

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

ALTERNATIV:

Om du vill kontrollera vilka kommunikationsalternativ som är tillgängliga för en resurs kan du använda det här kommandot. När du anger kommandot får du en lista över de kommunikationsmetoder som är tillgängliga för en viss resurs tillsammans med annan relevant information, t.ex. autentiseringsscheman som stöds, förfrågningsrubriker och innehållstyper.

HEAD:

Detta kommando gör det möjligt att hämta innehållets rubriker utan att ha att göra med det faktiska innehållet. På så sätt kan en utvecklare få nödvändig information om innehållsdelar, t.ex. cachningsinformation, innehållstyp och innehållslängd, utan att behöva ladda ner dem.

PATCH:

Med det här kommandot kan du uppdatera en viss del av ett innehåll. Det liknar till viss del PUT, men du behöver inte ersätta en viss resurs helt och hållet. På så sätt kan du uppdatera titeln eller innehållet i ett inlägg, samt metadata som är kopplade till en användare, medan resten förblir detsamma.

När du använder kommandot måste du ange vilka ändringar du vill utföra. Om du t.ex. vill redigera titeln måste du lägga till detta i request body:

"title": "Ny titel för inlägg"

Slutsats

WordPress REST API är ett multifunktionellt gränssnitt som gör att dina applikationer kan interagera med din WordPress-webbplats. Gränssnittet hanteras med hjälp av olika kommandon, som vi har tillägnat dagens artikel. Vi hoppas att den här informationen var användbar, tack för din tid!