Forståelse af WordPress REST API: En guide til udviklere

Introduktion

At oprette en hjemmeside er en kompleks proces i flere trin. Til at begynde med skal du først finde en hostingløsning af høj kvalitet til det. Hvis du vil oprette en ny hjemmeside og ikke har et meget stort behov for ressourcer og forventer meget høj trafik, er en VPS-server en alsidig løsning, der vil være velegnet til de fleste hjemmesider. Hvis betalingsmetoden betyder noget for dig, skal du vide, at du kan vælge mellem en række forskellige muligheder, såsom kreditkort-VPS, bitcoin-VPS, AliPay-VPS osv.

Et andet grundlæggende aspekt ved at skabe en hjemmeside er valget af et CMS - content management system, et specialværktøj, der bruges til at fylde hjemmesiden med indhold og ændre det. Hvis du vælger WordPress, bliver dine udviklere nødt til at håndtere WordPress REST API.

Wordpress er et af de mest populære CMS til opbygning af hjemmesider i dag. REST API er til gengæld en vigtig grænseflade, der bruges til at arbejde med en Wordpress-hjemmeside. Takket være REST API får dine applikationer mulighed for at interagere med din hjemmeside via JSON-filer. På den måde kan udviklere bygge brugerdefinerede applikationer, hjemmesider og plugins oven på Wordpress. REST API giver udviklere mulighed for at interagere med Wordpress-data ved hjælp af HTTP-kommandoer.

I det følgende skal vi se på nogle vigtige kommandoer, som vil være nyttige for enhver udvikler.

WordPress REST API: Essentials

GET:

Den bruges til at hente data fra WordPress-databasen ved hjælp af HTTP GET-metoden. Denne kommando er en af de mest almindelige og er den første kommando, du bruger, før du rent faktisk gør noget med dine data.

Det gør det muligt at hente en specifik ressource som f.eks. et indlæg, en side eller en brugerdefineret indlægstype uden at modificere den.

For at bruge metoden skal du sende en forespørgsel til et specifikt endpoint med et givet sæt parametre. Endpointet præsenteres af en URL til ressourcen med de parametre, du ønsker at hente - for eksempel ressourcens ID, filtreringsmuligheder, pagineringsoplysninger og andre forespørgselsparametre.

Hvis du skriver dette:

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

får du detaljerne om indlægget med dette særlige ID, såsom titel, indhold, forfatter og andre metadata.

Desuden kan du få oplysninger om en liste over ressourcer. Hvis du f.eks. vil se alle publicerede, skal du tilføje /wp/v2/posts?status=publish til endpoint-requesten:

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

POST:

Denne kommando bruges til at tilføje noget nyt til din hjemmeside. Det kan faktisk være et indlæg, men det kan også bruges til sider, kommentarer og andre vedhæftede filer.

For at oprette et nyt indlæg skal du tilføje /wp/v2/posts til endpointet.

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

I payload'en kan du så inkludere data for det nye indlæg, såsom titel, indhold, forfatter og andre metadata:

"title": "Mit nye indlæg", "content": "Dette er indholdet af mit nye indlæg.", "author": 1, "status": "publish"

PUT:

POST bruges til at oprette tomme kladder til sider og indlæg. For yderligere at opdatere en med nyt indhold kan du bruge PUT-kommandoen. Den kan også bruges til at udgive tidligere oprettede kladder.

Hvis du vil se alle de aktuelle kladder, kan du bruge POST-kommandoen på denne måde:

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

Herefter kan du bruge PUT-kommandoen til at ændre status for en bestemt kladde ved at indtaste dens ID:

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

Dette giver adgang til dit indlæg med mulighed for at ændre det. Nu skal du skifte status fra "kladde" til "udgiv":

"status" = "udgiv"

Derudover kan du tilføje mere indhold til den ved hjælp af "status"-argumentet:

"status" = "udgiv" "indhold" = "indhold her"

DELETE:

En anden vigtig kommando, der bruges til at slette indlæg, sider, indhold og brugere. Et slettet indlæg vil først blive smidt i papirkurven.

For at slette et bestemt indlæg, for eksempel det, der er oprettet ovenfor, skal du indtaste noget i denne retning:

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

Hvis du vil slette indlægget for altid uden at sende det i skraldespanden, skal du tilføje ?force=true efter det:

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

MULIGHEDER:

Hvis du vil tjekke en ressource for de kommunikationsmuligheder, der er tilgængelige for den, kan du bruge denne kommando. Når du indtaster kommandoen, får du en liste over de kommunikationsmetoder, der er tilgængelige for en bestemt ressource, sammen med andre relevante oplysninger, f.eks. understøttede godkendelsesordninger, request-headere og indholdstyper.

HOVED:

Denne kommando gør det muligt at hente indholdets headers uden at have med det faktiske indhold at gøre. På denne måde kan en udvikler få de nødvendige oplysninger om dele af indholdet, såsom cache-oplysninger, indholdstype og indholdslængde, uden at skulle downloade dem.

PATCH:

Denne kommando giver dig mulighed for at opdatere en bestemt del af et stykke indhold. Den minder lidt om PUT, men du behøver ikke at erstatte en bestemt ressource helt. På denne måde kan du opdatere titlen eller indholdet af et indlæg samt metadata, der er knyttet til en bruger, mens resten forbliver det samme.

Når du bruger kommandoen, skal du angive, hvilke ændringer du ønsker at udføre. Hvis du f.eks. vil redigere titlen, skal du tilføje den til request body:

"title": "Titel på nyt indlæg"

Konklusion

WordPress REST API er en multifunktionel grænseflade, der gør det muligt for dine applikationer at interagere med dit WordPress-site. Interfacet styres ved hjælp af forskellige kommandoer, som vi har dedikeret dagens artikel til. Vi håber, at disse oplysninger var nyttige, tak for din tid!