WordPress REST API är en kraftfull funktion som låter utvecklare interagera med en WordPress-webbplats på ett nytt och flexibelt sätt. Genom att använda REST API kan du skapa, läsa, uppdatera och radera data på din webbplats från externa applikationer, vilket öppnar upp för nya möjligheter inom webb- och applikationsutveckling. I denna guide går vi igenom grunderna i WordPress REST API och hur du kan använda det.
Steg 1: Förstå grunderna i REST API
Vad är REST API?
REST (Representational State Transfer) är en arkitekturstil för att designa nätverksapplikationer. Ett RESTful API använder HTTP-förfrågningar för att utföra CRUD-operationer (Create, Read, Update, Delete) på resurser.
Fördelar med WordPress REST API
- Flexibilitet: Möjliggör integration med andra applikationer och tjänster.
- Decoupling: Skapa separata frontend-applikationer som kommunicerar med WordPress via API.
- Utökningsbarhet: Lägg till egna anpassade slutpunkter för att hantera specifika data och funktioner.
Steg 2: Komma igång med WordPress REST API
Aktivera REST API
REST API är aktiverat som standard i WordPress version 4.7 och senare. Det krävs ingen ytterligare installation eller konfiguration för att komma igång.
Grundläggande REST API-slutpunkter
WordPress REST API erbjuder flera standardiserade slutpunkter för att interagera med webbplatsens data.
Här är några exempel:
- Inlägg: /wp-json/wp/v2/posts
- Sidor: /wp-json/wp/v2/pages
- Kommentarer: /wp-json/wp/v2/comments
- Användare: /wp-json/wp/v2/users
Testa REST API med en webbläsare
För att testa REST API kan du använda din webbläsare eller verktyg som Postman.
För att hämta alla inlägg, skriv följande URL i din webbläsare:
https://dinwebbplats.com/wp-json/wp/v2/posts
Steg 3: Autentisering och säkerhet
Autentiseringstyper
- Basic Authentication: En enkel metod där användarnamn och lösenord skickas med varje förfrågan. Används främst för testning.
- OAuth: En säkrare metod som används för att ge tredjepartsapplikationer begränsad åtkomst till resurser.
- Application Passwords: En metod som tillåter autentisering utan att använda det vanliga användarlösenordet.
Installera Application Passwords-plugin
- Navigera till Plugins > Lägg till nytt: Sök efter ”Application Passwords”.
- Installera och aktivera pluginet: Klicka på ”Installera nu” och sedan ”Aktivera”.
- Generera ett applikationslösenord: Gå till Användare > Din profil och skapa ett nytt applikationslösenord.
Steg 4: Använda REST API för att hämta data
Hämta alla inlägg
Använd en GET-förfrågan till följande URL för att hämta alla inlägg:
GET https://dinwebbplats.com/wp-json/wp/v2/posts
Hämta ett specifikt inlägg
Använd en GET-förfrågan med inläggs-ID för att hämta ett specifikt inlägg:
GET https://dinwebbplats.com/wp-json/wp/v2/posts/123
Hämta inlägg med filter
Använd query-parametrar för att filtrera resultaten, till exempel för att hämta de senaste 5 inläggen:
GET https://dinwebbplats.com/wp-json/wp/v2/posts?per_page=5
Steg 5: Skapa, uppdatera och radera data med REST API
Skapa ett nytt inlägg
Använd en POST-förfrågan för att skapa ett nytt inlägg.
Inkludera autentisering och inläggsdata i förfrågan:
POST https://dinwebbplats.com/wp-json/wp/v2/posts Authorization: Basic [ditt applikationslösenord] Content-Type: application/json { "title": "Nytt inlägg", "content": "Detta är innehållet i det nya inlägget.", "status": "publish" }
Uppdatera ett befintligt inlägg
Använd en PUT-förfrågan för att uppdatera ett befintligt inlägg.
Inkludera inläggs-ID i URL:en:
PUT https://dinwebbplats.com/wp-json/wp/v2/posts/123 Authorization: Basic [ditt applikationslösenord] Content-Type: application/json { "title": "Uppdaterat inlägg", "content": "Detta är det uppdaterade innehållet i inlägget." }
Radera ett inlägg
Använd en DELETE-förfrågan för att radera ett inlägg.
Inkludera inläggs-ID i URL:en:
DELETE https://dinwebbplats.com/wp-json/wp/v2/posts/123 Authorization: Basic [ditt applikationslösenord]
Steg 6: Utöka REST API med egna slutpunkter
Skapa en egen slutpunkt
Du kan utöka WordPress REST API genom att skapa egna slutpunkter.
Lägg till följande kod i ditt tema eller plugin för att skapa en ny slutpunkt:
add_action('rest_api_init', function () { register_rest_route('myplugin/v1', '/data/', array( 'methods' => 'GET', 'callback' => 'myplugin_get_data', )); }); function myplugin_get_data() { return new WP_REST_Response(array('data' => 'Här är din data'), 200); }
Testa din egen slutpunkt
Efter att ha lagt till koden, testa din nya slutpunkt genom att besöka:
https://dinwebbplats.com/wp-json/myplugin/v1/data
Slutsats
WordPress REST API erbjuder en flexibel och kraftfull metod för att interagera med din webbplats data. Genom att följa denna guide kan du lära dig att använda och utöka REST API för att skapa dynamiska och moderna webbapplikationer. Utforska de olika autentiseringsmetoderna och testa att skapa egna slutpunkter för att utnyttja hela potentialen i WordPress REST API. Lycka till med din utveckling!