WordPress har bara ett JSON API. Här är varför detta är

WordPress startade som en ödmjuk bloggplattform, och på något sätt befann sig sig till att bli ett fullfjädrad innehållshanteringssystem som driver en betydande del av Internet, inklusive den här webbplatsen. Trots det har WordPress ett antal anmärkningsvärda begränsningar, inklusive ett korrekt API.

Jo det är inte riktigt sant. Naturligtvis har WordPress i många år haft en XML-baserad Vad är en XML-fil och vad är dess användningsområden? [Om du undrade] Vad är en XML-fil och vad är dess användning? [Om du undrade] Läs mer Programmeringsgränssnitt (API) som tillåter utvecklare att skapa tredjepartsapplikationer Vad är API: er och hur är öppna API: er som ändrar Internet? Vad är API: er och hur är öppna API-filer som ändrar Internet Har du någonsin undrade hur program på din dator och de webbplatser du besöker "prata" med varandra? Läs mer som interagerar med WordPress. Men XML är hemskt. Det är långsamt att analysera. Det är svårt att läsa. Det är förvånansvärt ordentligt. JSON är mycket, mycket bättre Vad är JSON? A Laymans översikt Vad är JSON? En Laymans översikt Oavsett om du planerar att vara webbutvecklare eller inte, är det en bra idé att åtminstone veta vad som är JSON, varför det är viktigt och varför det används över hela webben. Läs mer . Det är snabbt att analysera, mer mänskligt och snabbt har blivit det språk som valts för API-utvecklare.

Under ett tag har utvecklare gråt för ett JSON API för WordPress. Detta skulle göra det väsentligt enklare att skapa program från tredje part och webbplatser som interagerar med WordPress-baserade webbplatser på ett sätt som är modernt och stöds på många olika språk och plattformar.

Efter nästan elva års väntan har deras böner besvarats. Den (snappily named) JSON REST API-plugin har funnits i verket ett tag nu och har äntligen nått version 1.0. Det betyder att den har nått en fullständig funktion och har en stabilitet som gör den redo för produktionsmiljöer. Dessutom kommer funktionaliteten i det här plug-ins snart att integreras med WordPress-kärnan, och det förväntas presenteras fullt ut av WordPress 4.0. Det är verkligen framtiden.

Detta är en milstolpe release av en stor plugin, och ett med betydande löfte för utvecklare, webbplatsägare och konsumenter. Övertygad? Så här kan du börja använda det idag.

Installera pluginprogrammet

Det finns en mängd plugins som lovar att göra det enkelt att lägga till ett JSON API till WordPress. Men ingen av dem är så polerade och kompletta som den officiella, genuina artikeln.

När du går in i plugin-webbläsaren i WordPress, se till att du laddar ned den som säger "JSON REST API (WP API)" och är av Ryan McCue, som är medlem i WordPress-kärnteamet. Den här artikeln gäller endast det specifika plugin-programmet.

Interagera med API

När det är installerat kommer WordPress JSON API att exponeras under http://yourdomain.com/wp-json/ katalogen. Eventuella frågor till API måste skickas här, och kan göras genom att skicka en enkel HTTP-begäran via din webbläsare eller via ett HTTP-bibliotek i ditt favoritprogrammeringsspråk. Nästa demonstration av API: n kommer att vara ganska fokuserad på användningen av API: n. Vi kommer att fråga det via webbläsaren, men i den verkliga världen kommer du antagligen att sluta använda något som Pythons värdiga begäran-bibliotek, eller CURL.

Enkelt nog. Men vi har fortfarande inte diskuterat hur man frågar API: n. Som jag är säker på att du gissade är WordPress API fenomenalt enormt. Jag menar, WordPress är enorm. Det är ett projekt av gigantisk storlek, som består av miljoner kodrader och tusentals bidragsgivare. Det finns inget sätt att vi kan täcka API: n i sin helhet i ett enda blogginlägg. Om du är intresserad av att läsa vidare till det här API-skriptet, är det bäst att titta på dokumentationen, som samtidigt är omfattande, men också överraskande lätt att läsa.

En sak till. Jag har installerat JSONView plugin för att göra den utmatade texten lite mer läsbar. Det här pluginet är gratis och tillgängligt för Chrome och Firefox.

Så, låt oss börja. Låt oss först se olika typer av frågor som vi kan göra mot JSON API. Öppna din webbläsare och navigera till http: // dindomän / wp-json /.

Som du kan se visar det här omfattande åtgärderna du kan göra mot JSON API, och inkluderar att lägga till och manipulera användardata, lägga till inlägg och visa inlägg som redan har publicerats. Handily visar detta vilka förfrågningar som krävs variabler skickas, liksom de HTTP-metoder som kan användas mot dem.

Men låt oss gå vidare. Här kan du se att vi har navigerat till en vy som visar alla inlägg som har publicerats. Inte bara får du inläggen själva, men en betydande mängd metadata för varje inlägg.

Om du vill välja ett enskilt inlägg behöver du bara lägga till ett framåt-snedstreck och postnummerets numeriska ID.

Du kan också skriva sökfrågor via API: n, så att du kan få tillbaka inlägg som matchar en viss fråga. Detta görs genom att skicka en HTTP-begäran till http://yourdomain.com/wp-json/posts?filter[s]=query.

Du kan också komma åt och uppdatera användarinformation via API: n. Även om det är värt att notera måste du verifieras. Det här är lugnande, eftersom ett API ofta kan vara en avenue för informationsinformation och säkerhetsbrott.

Så, varför gör det här?

För det första betyder det att det aldrig varit enklare för utvecklare att integrera sina applikationer med WordPress-plattformen. Förvänta dig att se några mycket imponerande mobila applikationer och webbplatser som dyker upp runt WordPress-plattformen. Förvänta sig också att WordPress-kunder ska hitta sina sätt att bygga nisch mobila databehandlingsplattformar, till exempel Blackberry 10 10 skäl att ge BlackBerry 10 ett försök idag 10 skäl att ge BlackBerry 10 ett försök idag BlackBerry 10 har några ganska oemotståndliga funktioner. Här är tio anledningar till att du kanske vill ge det ett steg. Läs mer och Firefox OS.

Vi kan också låsa upp data som finns kvar på våra WordPress-webbplatser utan att behöva manuellt utföra databasfrågor, använda det mycket (och rättfärdigt) malignerade XML-RPC-baserade API-systemet eller skriva komplicerade webbskraparprogram med en plattform som Scraperwiki Doing Data Science i Cloud med ScraperWiki Göra datavetenskap i molnet med ScraperWiki Datavetenskap är den nya stora grejen i teknik; högt trendiga och mycket betalda, med datavetenskapare som sökts av några av världens största företag. Läs mer .

Dessutom föreslår det att WordPress flyttar sig bort från att vara en plattform som används uteslutande för bloggar och innehållshantering och har en vision att bli ett verktyg för att skapa mer komplexa och ambitiösa produkter, vilket indikeras av att ett utökat JSON API, som kommer att så småningom hitta sin väg till WordPress-kärnan. Man kan tro att det går till Django.

Är du uppspelt?

Men vad tycker du? Är du en utvecklare? Upphetsad över att kunna komma åt WordPress med ett JSON API, eller tycker det är slöseri med tid? Är du en konsument och glada att se WordPress integrera med fler produkter och tjänster? Låt mig veta dina tankar i kommentarerna nedan.

Fotokrediter: Ge mig JSON eller ge mig död (Ed Summers), WordPress Logo (Phil Oakley)

Utforska mer om: API, Blogging, Wordpress, Wordpress-plugins.