Wordpress REST API poskytuje vývojářům mocný nástroj pro práci s WordPressem na dálku pomocí HTTP požadavků. Přestože standardně podporuje základní typy obsahu jako příspěvky, stránky a média, mnohdy je potřeba API rozšířit o vlastní datové typy a endpointy, aby lépe sloužilo specifickým potřebám projektu. V tomto článku se dozvíte, jak na to.
1. Definice vlastního datového typu
Prvním krokem je vytvoření vlastního datového typu (Custom Post Type - CPT), pokud již není definován. To lze provést pomocí funkce register_post_type() ve vašem pluginu nebo tématu. Při registraci je klíčové nastavit argument show_in_rest na true, aby byl nový datový typ dostupný v REST API.
2. Přidání vlastního endpointu
Pro vytvoření nového endpointu využijeme hook rest_api_init a funkci register_rest_route(). Tato funkce umožňuje definovat metodu (GET, POST, atd.), cestu k endpointu a callback funkci, která se má vykonat při zavolání endpointu.
add_action('rest_api_init', function () {
register_rest_route('mujplugin/v1', '/mojedata/', array(
'methods' => 'GET',
'callback' => 'moje_funkce_zpracovani',
));
});
3. Zpracování požadavků
V callback funkci moje_funkce_zpracovani můžete zpracovat požadavek a vrátit odpovídající data. Je možné přistupovat k globálním proměnným, vlastním databázovým tabulkám nebo jakýmkoli jiným zdrojům potřebným pro generování odpovědi.
4. Autentizace a oprávnění
Pro zabezpečení přístupu k vlastním endpointům je možné využít různé metody autentizace, například Basic Auth nebo OAuth. K ověření oprávnění uživatele můžete v callback funkci použít funkce jako current_user_can().
5. Testování a ladění
Po implementaci je důležité endpointy řádně otestovat. Můžete využít nástroje jako Postman nebo cURL pro odesílání HTTP požadavků a ověření správné funkčnosti vašich endpointů.
Rozšíření WP REST API o vlastní datové typy a endpointy otevírá dveře k pokročilým integracím a funkcionalitám vašich WordPress projektů. S trochou kódu můžete výrazně zvýšit flexibilitu a možnosti vašeho webu.
