Zaktualizowano dnia 20 października 2026.
Jeśli używasz wtyczki Semly, zacznij od jej dokumentacji połączenia. Poniższa diagnoza nadal dotyczy standardowego REST API WordPressa; hasło aplikacji nie jest wymaganiem mechanizmu parowania wtyczki Semly.
Ta instrukcja dotyczy zapisu wpisu przez standardowe REST API samodzielnie utrzymywanego WordPressa. Nie opisuje konfiguracji konkretnej wtyczki Semly ani API WordPress.com. Celem jest ustalenie, gdzie żądanie zawodzi, i potwierdzenie zapisu szkicu.
1. Zbierz odpowiedź i właściwy adres
Zapisz metodę HTTP, pełny adres bez sekretów, godzinę, status odpowiedzi, jej typ i pola błędu code oraz message, jeśli są dostępne. Dla standardowych wpisów sprawdź ścieżkę /wp-json/wp/v2/posts. Instalacja w podkatalogu lub własny typ wpisu może mieć inny adres.
Otwórz /wp-json/ i sprawdź dostępne trasy. Alternatywny zapis ?rest_route=/wp/v2/posts pomaga sprawdzić problem z przepisywaniem adresu. Sam działający odczyt nie potwierdza prawa zapisu.
2. Rozdziel możliwe przyczyny
| Status | Co sprawdzić |
|---|---|
| 401 | Dane uwierzytelnienia, HTTPS i przekazanie nagłówka Authorization |
| 403 | Wymagane uprawnienia, filtr wtyczki, reguła WAF lub proxy |
| 404 | Adres, metoda, rejestracja trasy albo ID aktualizowanego wpisu |
Status sam nie rozstrzyga przyczyny. rest_cannot_create nie dowodzi poprawnego uwierzytelnienia. JSON może pochodzić także z proxy, a HTML nie dowodzi, że WordPress nie obsłużył żądania. Porównaj odpowiedź z logami administratora.
3. Sprawdź uwierzytelnienie i uprawnienia
Dla obsługiwanego połączenia zewnętrznego użyj osobnego hasła aplikacji przypisanego do użytkownika i HTTPS. Nie wpisuj głównego hasła konta ani sekretu do zgłoszenia. Administrator może sprawdzić, czy proxy przekazuje nagłówek Authorization; nie zapisuj jego wartości w logach.
Odczyt /wp-json/wp/v2/users/me z poprawnym uwierzytelnieniem potwierdza rozpoznanie użytkownika, ale nie możliwość tworzenia wpisu. Sprawdź uprawnienia wymagane dla danego typu treści. Zapis szkicu i publiczna publikacja to różne operacje. Uwierzytelnienie ciasteczkiem wewnątrz WordPressa ma inne wymagania, w tym nonce, niż hasło aplikacji.
4. Przetestuj szkic
W kliencie API ustaw:
POST https://example.com/wp-json/wp/v2/posts
Content-Type: application/json
{"title":"Test API","content":"Test zapisu szkicu","status":"draft"}
Skonfiguruj uwierzytelnienie w kliencie bez umieszczania sekretu w udostępnianym przykładzie. Sprawdź odpowiedź, ID i status, a następnie odszukaj szkic w panelu. Przy niepewnej odpowiedzi sprawdź, czy wpis powstał, zanim ponowisz zapis: kolejny POST może utworzyć duplikat.
5. Przekaż diagnozę i odbierz naprawę
Zgłoszenie powinno zawierać czas, trasę, metodę, zanonimizowaną odpowiedź i informację o ostatniej zmianie konfiguracji. Nie wyłączaj całego zabezpieczenia ani nie nadawaj administratora tylko po to, by test przeszedł. Administrator powinien ustalić konkretną regułę i minimalne wymagane uprawnienia.
Naprawa jest potwierdzona, gdy ten sam test tworzy jeden szkic na właściwym koncie i ID daje się ponownie odczytać. Publikacja publiczna nie jest potrzebna do tej diagnozy.