Jak włączyć obsługę REST API w .htaccess na hostingu SEOHOST.pl

Coraz więcej aplikacji webowych – od paneli klienta, przez sklepy internetowe, po integracje mobilne – komunikuje się z serwerem przez REST API, czyli interfejs oparty na standardowych metodach HTTP (GET, POST, PUT, DELETE). Jeśli na Twoim hostingu żądania do API kończą się błędami 403 lub 405, bardzo często wystarczy jedna prosta reguła w pliku .htaccess, aby odblokować obsługę REST API dla wybranej domeny – dokładnie to pokazuję w tym poradniku krok po kroku.

• Czym jest REST API i kiedy jest potrzebne
• Wideo instrukcja – REST API w .htaccess
• Gdzie znaleźć plik .htaccess w DirectAdmin
• Jak dopisać obsługę REST API w .htaccess
• Włączenie REST API dla wielu domen
• Podsumowanie

Czym jest REST API i kiedy jest potrzebne

REST API (Representational State Transfer) to styl komunikacji klient–serwer oparty na protokole HTTP, w którym do pracy z zasobami wykorzystuje się standardowe metody HTTP, przede wszystkim GET, POST, PUT oraz DELETE.

W praktyce oznacza to, że Twoja aplikacja (np. panel administracyjny, CRM, integracja mobilna czy sklep korzystający z endpointów API) wysyła żądania pod konkretne adresy URL i oczekuje odpowiedzi w formacie JSON lub XML. Jeśli serwer WWW domyślnie blokuje część metod HTTP, konieczne jest ich jawne odblokowanie w .htaccess, aby aplikacja mogła poprawnie wykonywać operacje zapisu, aktualizacji i usuwania danych.

Wideo instrukcja jak włączyć obsługę REST API w .htaccess

Kliknij w link, aby zapoznać się z materiałem filmowym pokazującym, jak krok po kroku włączyć obsługę REST API w pliku .htaccess w DirectAdmin.

Gdzie znaleźć plik .htaccess w DirectAdmin

Aby poprawnie działały zapytania REST API na danej domenie, konieczne jest umieszczenie prostego kodu w pliku .htaccess tej domeny.

Plik .htaccess można znaleźć w katalogu głównym domeny. W przypadku naszej testowej domeny jest to katalog: /domains/nowanazwadomeny.pl/public_html. Jest to standardowa lokalizacja dla stron WWW opartych o hosting współdzielony w SEOHOST.pl, dlatego warto zapamiętać tę ścieżkę, jeśli pracujesz z wieloma projektami jednocześnie.

Można edytować ten plik, wchodząc w menadżer plików w DirectAdmin. Menadżer znajduje się w sekcji „Informacje o systemie i pliki” → „Zarządzanie plikami”.

Następnie przejdź kolejno do katalogów:

• domains
• nazwa_domeny – będzie to katalog z faktyczną nazwą domeny, w naszym przypadku jest to katalog nowanazwadomeny.pl
• public_html lub private_html – katalog zależy od konfiguracji certyfikatu SSL dla domeny, o którym piszemy w innym poradniku, zazwyczaj jednak jest to katalog public_html

Po wejściu do odpowiedniego katalogu należy przejść do edycji pliku .htaccess.

Jak dopisać obsługę REST API w .htaccess

Poniższą regułę wklej poniżej wszystkich dyrektyw, które już znajdują się w pliku .htaccess – dzięki temu nie nadpiszesz aktualnych ustawień przekierowań czy zabezpieczeń:

<Limit GET POST PUT DELETE>
Allow from all
</Limit>

Po wklejeniu kodu zapisz plik. Od tej chwili obsługa REST API jest włączona dla danej domeny i wraz z nią wszystkie metody umieszczone w dyrektywie Limit. Jeżeli administrator serwera korzysta z nowszej składni uprawnień (np. Require all granted w Apache 2.4), konfiguracja może być rozszerzona lub dopasowana po stronie serwera – w razie wątpliwości warto skonsultować zapis z BOK.

Włączenie REST API dla wielu domen

Jeśli na innych domenach na tym samym hostingu również potrzebujesz dostępu do REST API, musisz powtórzyć powyższą operację dla plików .htaccess w katalogach każdej z domen. Dzięki temu każda aplikacja (np. osobne instalacje CMS lub paneli API) będzie mogła korzystać z metod HTTP bez zbędnych błędów uprawnień.

Całą tę operację można także wykonać przez FTP. Wystarczy połączyć się z serwerem i edytować plik znajdujący się w katalogu wybranej domeny. Możesz również przygotować plik .htaccess lokalnie na swoim komputerze, a następnie przesłać go na serwer za pomocą FTP – sposób połączenia z serwerem przez FTP opisujemy w innym naszym poradniku. Takie podejście przyspiesza pracę, gdy konfigurujesz jednocześnie kilka środowisk deweloperskich wykorzystujących REST API.

Podsumowanie

Jak widzisz, włączenie obsługi REST API w .htaccess na serwerze z DirectAdmin sprowadza się do odnalezienia właściwego pliku dla danej domeny i dopisania krótkiej dyrektywy Limit obejmującej metody GET, POST, PUT oraz DELETE. W połączeniu z poprawną konfiguracją aplikacji po stronie kodu szybko rozwiązuje to większość problemów z błędami dostępu do endpointów REST.

Ważne: po wprowadzeniu zmian w .htaccess sprawdź działanie aplikacji na kilku kluczowych endpointach REST (np. logowanie, zapis danych, kasowanie wpisów). Jeśli pojawią się błędy 403 lub 500, wróć do pliku i upewnij się, że dyrektywa Limit została dopisana w odpowiednim miejscu, a inne reguły nie blokują ruchu do API.

Jeżeli dopiero przenosisz aplikację lub sklep korzystający z REST API na nowy serwer, rozważ niezawodny i szybki hosting pod aplikacje wykorzystujące REST API – stabilna infrastruktura i aktualne oprogramowanie serwera znacząco zmniejszają ryzyko problemów z konfiguracją .htaccess oraz obsługą metod HTTP.