Czym jest REST API w WordPress i jak z niego korzystać?

WordPress to nie tylko system do tworzenia stron internetowych – to również potężne narzędzie developerskie. Jednym z jego największych atutów jest REST API, które pozwala na komunikację z Twoją stroną poprzez zapytania HTTP. Dzięki temu możesz tworzyć aplikacje mobilne, integracje z innymi systemami czy dynamiczne elementy frontendowe.

1. Co to jest REST API?

REST API (Representational State Transfer Application Programming Interface) to sposób komunikacji aplikacji za pomocą protokołu HTTP. W WordPressie REST API pozwala pobierać i wysyłać dane takie jak:

• wpisy i strony,
• użytkownicy,
• komentarze,
• taksonomie (tagi, kategorie),
• dane własnych typów postów (Custom Post Types).

Przykład zapytania GET do pobrania postów:

https://twojadomena.pl/wp-json/wp/v2/posts

Otrzymasz dane w formacie JSON, które możesz wykorzystać np. w aplikacji mobilnej.

2. Jak włączyć i sprawdzić REST API w WordPress?

REST API jest wbudowane w WordPressa od wersji 4.7, więc zazwyczaj działa od razu.
Możesz to sprawdzić, wpisując w przeglądarkę:

https://twojadomena.pl/wp-json

Jeśli zobaczysz dane w formacie JSON, oznacza to, że API działa poprawnie.

3. Pobieranie danych przez REST API

Przykładowe endpointy:

• Lista postów: /wp-json/wp/v2/posts
• Pojedynczy post: /wp-json/wp/v2/posts/123
• Kategorie: /wp-json/wp/v2/categories
• Użytkownicy: /wp-json/wp/v2/users

4. Wysyłanie danych (metody POST, PUT, DELETE)

REST API umożliwia również dodawanie, edytowanie i usuwanie treści. Wymaga to jednak uwierzytelnienia (np. przy pomocy Basic Auth lub JWT).

Przykład dodania posta (POST):

curl -X POST https://twojadomena.pl/wp-json/wp/v2/posts \
    -u admin:haslo \
    -H "Content-Type: application/json" \
    -d '{"title":"Nowy post","status":"publish"}'

5. Tworzenie własnych endpointów

Możesz zarejestrować własny endpoint w pliku functions.php lub wtyczce:

add_action('rest_api_init', function () {
    register_rest_route('mojeapi/v1', '/powitanie', array(
        'methods' => 'GET',
        'callback' => function () {
            return array('message' => 'Witaj w moim API!');
        },
    ));
});

Teraz pod adresem:

https://twojadomena.pl/wp-json/mojeapi/v1/powitanie

zobaczysz komunikat JSON.

6. Praktyczne zastosowania

• Aplikacje mobilne – aplikacja korzysta z danych WordPressa.
• Integracje – np. z CRM lub sklepem internetowym.
• Headless WordPress – gdy backend to WordPress, a frontend działa np. w React czy Vue.
• Widgety i dynamiczne sekcje – pobieranie najnowszych postów przez JS.

Podsumowanie

REST API w WordPress to niezwykle elastyczne narzędzie, które pozwala traktować stronę nie tylko jako CMS, ale też jako platformę developerską. Dzięki niemu możesz łatwo integrować WordPressa z innymi aplikacjami i tworzyć nowoczesne projekty webowe.