Endpointy
| Metoda | Ścieżka | Opis |
|——–|———|——|
| GET | /kb/entries.json?knowledge_base_id=X | Lista wpisów w bazie |
| GET | /kb/entries/:id.json | Pojedynczy wpis |
| POST | /kb/entries.json | Utworzenie wpisu |
| PATCH | /kb/entries/:id.json | Aktualizacja wpisu |
| DELETE | /kb/entries/:id.json | Usunięcie wpisu |
| POST | /kb/entries/:id/change_priority | Zmiana priorytetu |
| POST | /kb/entries/:id/change_category | Zmiana kategorii |
| POST | /kb/entries/:id/make_private | Przełączenie prywatności |
| POST | /kb/entries/:id/add_connection | Dodanie powiązania |
| POST | /kb/entries/:id/remove_connection | Usunięcie powiązania |
Autoryzacja: Authorization: Bearer TOKEN (uprawnienie: kb)
Pola entry
| Pole | Typ | Wymagane | Opis |
|——|—–|———-|——|
| title | string | tak | Tytuł wpisu |
| content | string | tak | Treść (Markdown) |
| knowledge_base_id | integer | tak | ID bazy wiedzy |
| category_id | integer | nie | ID kategorii |
| status_id | integer | nie | ID statusu |
| private | boolean | nie | Czy prywatny |
| tags | array | nie | Tagi ["tag1", "tag2"] |
| priority | number | nie | Priorytet (domyślnie 1.0) |
| url | string | nie | Slug URL (auto-generowany) |
| html_title | string | nie | Meta tytuł SEO |
| html_description | string | nie | Meta opis SEO |
| publish_from | string | nie | Data publikacji YYYY-MM-DD |
| content_api | string | nie | Dokumentacja API (Markdown) |
| connected_entry_ids | array | nie | ID powiązanych wpisów |
| multilang_code | string | nie | Kod grupy tłumaczeń |
| fields | object | nie | Własne pola (JSONB) |
Filtrowanie
| Parametr | Opis |
|———-|——|
| q | Wyszukiwanie pełnotekstowe |
| knowledge_base_id | Filtruj po bazie wiedzy |
| category_id | Filtruj po kategorii |
| status_id | Filtruj po statusie |
| private | Filtruj po prywatności |
| tag | Filtruj po tagu |
Przykład utworzenia
{
"api_token": "TOKEN",
"entry": {
"title": "Jak dodać zadanie",
"content": "## Tworzenie zadania\n\n1. Przejdź do modułu **Zadania**\n2. Kliknij **+**\n3. Wypełnij formularz",
"knowledge_base_id": 1,
"category_id": 3,
"tags": ["zadania", "poradnik"]
}
}
Powiązanie wpisów
{
"api_token": "TOKEN",
"entry": {
"connected_entry_ids": [123, 456]
}
}
Uwaga: connected_entry_ids zastępuje całą listę — podaj wszystkie ID.