Blog

Kategoria publicznych endpointow API bloga.

Dostepne endpointy

• GET /api/posts

  • Zwraca liste opublikowanych wpisow blogowych.
  • Limit: do 100 rekordow.
  • Odpowiedz: { ok, posts }

• GET /api/posts/:slug

  • Zwraca pojedynczy opublikowany wpis blogowy po slug.
  • Bledy: 400 dla pustego slug, 404 gdy wpis nie istnieje.
  • Odpowiedz: { ok, post }

• GET /api/search?q=fraza

  • Przeszukuje opublikowane wpisy blogowe po tytule, slug, excerpt, tresci i nazwie kategorii.
  • Gdy parametr q jest pusty, endpoint zwraca najnowsze wpisy.
  • Odpowiedz: { ok, items, total }

• GET /:slug/json

  • Zwraca pelny JSON pojedynczego opublikowanego wpisu po slug.
  • Bledy: 400 dla pustego slug, 404 gdy wpis nie istnieje.
  • Odpowiedz: { ok, post }

• GET /api/categories

  • Zwraca liste kategorii bloga.
  • Obsluguje opcjonalny filtr q po slug lub name.
  • Odpowiedz: { ok, categories }

• POST /api/categories

  • Tworzy nowa kategorie bloga.
  • JSON body: { name, slug? }
  • Bledy: 400 dla niepoprawnych danych, 409 dla duplikatu slug.
  • Odpowiedz: { ok, category }

• GET /api/categories/:id

  • Zwraca pojedyncza kategorie po identyfikatorze.
  • Bledy: 400 dla niepoprawnego id, 404 gdy kategoria nie istnieje.
  • Odpowiedz: { ok, category }

• PUT /api/categories/:id

• PATCH /api/categories/:id

  • Aktualizuje kategorie bloga.
  • JSON body: { name?, slug? }
  • Bledy: 400 dla niepoprawnych danych, 404 gdy kategoria nie istnieje, 409 dla duplikatu slug.
  • Odpowiedz: { ok, category }

• DELETE /api/categories/:id

  • Usuwa kategorie, jesli nie jest domyslna i nie jest powiazana z wpisami.
  • Bledy: 400, 404, 409.
  • Odpowiedz: { ok: true }

Uwagi

• Wszystkie endpointy zwracaja JSON.
• Wszystkie endpointy przy bledzie zwracaja { ok: false, error }.
• Endpointy kategorii sa obecnie publicznie dostepne i nie maja dodatkowej warstwy autoryzacji.