WordPress REST API: Kompletní průvodce pro začátečníky

Představte si, že máte web postavený na WordPressu a chcete jeho obsah zobrazit v mobilní aplikaci, na jiném webu nebo ho zpracovat pomocí vlastního skriptu. Přesně k tomu slouží WordPress REST API – mocný nástroj, který otevírá dveře k neomezené flexibilitě. Pokud jste o REST API zatím jen slyšeli, ale nevěděli, kde začít, tento tutoriál je přesně pro vás.

Co je WordPress REST API a proč by vás mělo zajímat?

WordPress je dnes nejpoužívanější CMS (systém pro správu obsahu) na světě – pohání přes 40 % všech webových stránek. Jenže WordPress není jen o klasických webech. Díky REST API, které je součástí WordPressu od verze 4.7, se stal plnohodnotnou platformou pro vývojáře.

REST API (Representational State Transfer Application Programming Interface) je v podstatě komunikační most. Umožňuje jiným aplikacím nebo skriptům „mluvit" s vaším WordPressem prostřednictvím jednoduchých HTTP požadavků. Výsledkem jsou data ve formátu JSON – čitelném jak pro stroje, tak (po troše cviku) i pro lidi.

Co s WordPress REST API dokážete?

• Načíst seznam článků na vašem webu bez načítání celé stránky
• Vytvořit, upravit nebo smazat příspěvky programově
• Integrovat WordPress s externími aplikacemi (React, Vue.js, mobilní appky)
• Postavit tzv. headless WordPress – backend oddělený od frontendu
• Automatizovat publikování obsahu pomocí skriptů

Jak WordPress REST API funguje? Základní principy

Než se vrhneme na praktické příklady, pojďme si vysvětlit základy. REST API pracuje se čtyřmi základními HTTP metodami:

Každý endpoint (koncový bod) REST API má svou vlastní URL adresu. Základní struktura vypadá takto:

https://vašweb.cz/wp-json/wp/v2/[zdroj]

Kde [zdroj] může být například:

• posts – příspěvky
• pages – stránky
• categories – kategorie
• users – uživatelé
• media – média

Praktický příklad č. 1: Načtení článků přes prohlížeč

Nejjednodušší způsob, jak vyzkoušet WordPress REST API, nevyžaduje žádný kód. Stačí vám prohlížeč.

Zkuste to hned teď:

1. Otevřete libovolný web postavený na WordPressu
2. Do adresního řádku přidejte /wp-json/wp/v2/posts
3. Stiskněte Enter

Například: https://blog.wordpress.com/wp-json/wp/v2/posts

Prohlížeč vám zobrazí JSON odpověď se seznamem posledních příspěvků. Uvidíte informace jako název článku, obsah, datum publikování, autor a mnoho dalšího.

Tip pro začátečníky: Nainstalujte si do prohlížeče rozšíření jako JSON Formatter nebo JSONView. JSON data se vám zobrazí přehledně a čitelně místo jednoho velkého bloku textu.

Praktický příklad č. 2: Filtrování a parametry

REST API vám umožňuje data filtrovat pomocí parametrů v URL. Parametry se přidávají za otazník:

https://vašweb.cz/wp-json/wp/v2/posts?per_page=5&orderby=date&order=desc

Nejužitečnější parametry:

• per_page=10 – počet výsledků na stránku (max. 100)
• page=2 – číslo stránky pro stránkování
• search=wordpress – fulltextové vyhledávání
• categories=5 – filtr podle ID kategorie
• author=3 – filtr podle ID autora
• status=publish – pouze publikované příspěvky

Příklad: Chcete načíst 3 nejnovější příspěvky z kategorie s ID 12?

https://vašweb.cz/wp-json/wp/v2/posts?per_page=3&categories=12&orderby=date

Praktický příklad č. 3: Použití REST API s JavaScriptem

Tady začíná skutečná magie. Pomocí JavaScriptu a funkce fetch() můžete data z WordPress REST API načíst a zobrazit na libovolné stránce.

// Načtení posledních 5 článků
fetch('https://vašweb.cz/wp-json/wp/v2/posts?per_page=5')
.then(response => response.json())
.then(posts => {
posts.forEach(post => {
console.log(post.title.rendered); // Vypíše název článku
console.log(post.excerpt.rendered); // Vypíše perex
});
})
.catch(error => console.error('Chyba:', error));

Co tento kód dělá?

1. Pošle GET požadavek na endpoint /wp-json/wp/v2/posts
2. Převede odpověď do formátu JSON
3. Projde všechny příspěvky a vypíše jejich názvy a perex do konzole

Tento kód pak snadno upravíte tak, aby místo konzole plnil HTML element na vaší stránce.

Autentizace: Kdy ji potřebujete?

Čtení veřejně dostupného obsahu (publikované články, stránky, kategorie) nevyžaduje žádné přihlášení. Jakmile ale chcete data vytvářet, upravovat nebo mazat, nebo přistupovat k nepublikovanému obsahu, musíte se autentizovat.

Nejběžnější metody autentizace:

1. Application Passwords (doporučeno pro začátečníky)

Od WordPressu 5.6 je přímo zabudovaná podpora Application Passwords. Postup:

1. V administraci WordPressu jděte na Uživatelé → Váš profil
2. Sjeďte dolů na sekci Application Passwords
3. Zadejte název aplikace a klikněte na Add New Application Password
4. Zkopírujte vygenerované heslo (zobrazí se jen jednou!)

Toto heslo pak používáte v HTTP hlavičce při požadavcích:

const credentials = btoa('váš-login:xxxx xxxx xxxx xxxx xxxx xxxx');

fetch('https://vašweb.cz/wp-json/wp/v2/posts', {
method: 'POST',
headers: {
'Authorization': `Basic ${credentials}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Můj nový článek',
content: 'Obsah článku...',
status: 'publish'
})
});

2. JWT Authentication – populární plugin pro pokročilejší použití 3. OAuth – pro produkční aplikace s více uživateli

Praktický příklad č. 4: Vytvoření příspěvku pomocí REST API

Ukažme si, jak programově vytvořit nový příspěvek. Budeme potřebovat autentizaci (Application Password z předchozího kroku).

async function vytvorPrispevek() {
const login = 'váš-login';
const heslo = 'xxxx xxxx xxxx xxxx xxxx xxxx';
const credentials = btoa(`${login}:${heslo}`);

const novyPrispevek = {
title: 'Článek vytvořený přes REST API',
content: '<p>Toto je obsah mého prvního článku vytvořeného programově!</p>',
status: 'draft', // 'publish' pro okamžité publikování
categories: [5], // ID kategorií
tags: [12, 15]   // ID tagů
};

try {
const odpoved = await fetch('https://vašweb.cz/wp-json/wp/v2/posts', {
method: 'POST',
headers: {
'Authorization': `Basic ${credentials}`,
'Content-Type': 'application/json'
},
body: JSON.stringify(novyPrispevek)
});

const data = await odpoved.json();
console.log('Příspěvek vytvořen! ID:', data.id);
} catch (chyba) {
console.error('Něco se pokazilo:', chyba);
}
}

vytvorPrispevek();

Nejčastější chyby začátečníků a jak je řešit

🔴 Chyba 401 – Unauthorized Problém s autentizací. Zkontrolujte přihlašovací údaje a ujistěte se, že váš web používá HTTPS.

🔴 Chyba 403 – Forbidden Přihlášení proběhlo, ale nemáte oprávnění pro danou akci. Zkontrolujte role uživatele ve WordPressu.

🔴 Chyba 404 – Not Found Špatná URL nebo neexistující endpoint. Ověřte, zda máte správně nastavené trvalé odkazy (Nastavení → Trvalé odkazy → uložte).

🔴 CORS chyba v prohlížeči Pokud voláte API z jiné domény, může prohlížeč blokovat požadavek. Řešením je přidat CORS hlavičky na WordPress server nebo použít server-side proxy.

Rozšíření REST API o vlastní endpointy

Jednou z nejsilnějších funkcí WordPress REST API je možnost přidat vlastní endpointy. To se hodí, když chcete vystavit vlastní data nebo logiku.

// Přidejte do functions.php vašeho tématu

add_action('rest_api_init', function() {
register_rest_route('muj-plugin/v1', '/pozdrav', array(
'methods'  => 'GET',
'callback' => 'moje_pozdrav_funkce',
'permission_callback' => '__return_true'
));
});

function moje_pozdrav_funkce($request) {
return array(
'zprava' => 'Ahoj z mého vlastního endpointu!',
'cas'    => current_time('mysql')
);
}

Po přidání tohoto kódu bude váš endpoint dostupný na adrese: https://vašweb.cz/wp-json/muj-plugin/v1/pozdrav

WordPress REST API a moderní vývoj: Headless WordPress

Stále populárnější přístup je tzv. headless WordPress – WordPress slouží pouze jako backend a správce obsahu, zatímco frontend je postaven v moderním JavaScriptovém frameworku jako Next.js, Gatsby nebo Nuxt.js.

Výhody headless přístupu:

• Extrémní rychlost frontendu
• Svoboda výběru technologií
• Lepší bezpečnost (admin skrytý za API)
• Snadná integrace s CDN a statickým hostingem

Shrnutí a další kroky

WordPress REST API je fascinující nástroj, který přeměňuje WordPress z „pouhého" blogovacího systému na plnohodnotnou vývojářskou platformu. V tomto tutoriálu jste se naučili:

✅ Co je REST API a jak funguje ✅ Jak číst data pomocí GET požadavků ✅ Jak filtrovat výsledky pomocí parametrů ✅ Jak se autentizovat pomocí Application Passwords ✅ Jak vytvářet příspěvky programově ✅ Jak řešit nejčastější chyby ✅ Jak přidat vlastní endpointy

Váš první úkol: Otevřete prohlížeč, najděte libovolný WordPress web a přidejte /wp-json/wp/v2/posts za jeho adresu. Prohlédněte si strukturu dat a zkuste různé filtrovací parametry.

Chcete jít dál? Podívejte se na oficiální dokumentaci WordPress REST API nebo prozkoumejte nástroj Postman, který výrazně usnadní testování API požadavků.

WordPress REST API je vaší vstupenkou do světa moderního webového vývoje. Začněte jednoduše, experimentujte a postupně stavte složitější projekty. Svět headless WordPressu na vás čeká! 🚀

Máte otázky nebo narazili jste na problém? Napište nám do komentářů – rádi pomůžeme!