[Intum](https://intum.fr/aide.md) / [Organizacja](https://intum.fr/aide/organizacja.md)

# [Posty](https://intum.fr/aide/organizacja/posty.md) | [API](#api)

## Czym są posty?

Posty to wewnętrzne wpisy informacyjne w ramach zespołu lub projektu. Służą do dzielenia się wiedzą, ogłoszeniami i notatkami z członkami zespołu.

## Do czego służą posty

- **Ogłoszenia zespołowe** — informowanie członków zespołu o ważnych zmianach
- **Dokumentacja wewnętrzna** — spisywanie ustaleń, procedur i decyzji
- **Notatki projektowe** — dokumentowanie postępów i wniosków z projektu
- **Dyskusja** — posty mają sekcję komentarzy do omawiania tematu

## Tworzenie posta

1. Przejdź do **Zadania** → **Posty**
2. Kliknij **+** (Nowy post)
3. Wypełnij:
   - **Tytuł** — wymagany, temat posta
   - **Treść** — opis w edytorze Markdown z obsługą obrazów i załączników
   - **[Zespół](zespol)** — opcjonalne przypisanie do zespołu
   - **[Projekt](projekt)** — opcjonalne przypisanie do projektu
4. Zapisz

## Komentarze

Pod każdym postem dostępna jest sekcja komentarzy. Członkowie zespołu mogą dyskutować na temat posta, dodawać uwagi i załączniki.

## Załączniki

Do posta można dodawać pliki — zarówno inline w treści (obrazy) jak i jako osobne załączniki.

## Archiwizacja

Nieaktualne posty można zarchiwizować. Zarchiwizowane posty pozostają dostępne, ale nie pojawiają się na głównej liście.

## Ważne informacje

- Post może być przypisany do **zespołu** i/lub **projektu**
- Posty mają **licznik komentarzy** — widoczny na liście
- Post może mieć **typ** (kind) — do kategoryzacji wpisów
- Każdy post zapisuje kto go utworzył i ostatnio edytował

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/organize/posts.json` | Lista postów |
| GET | `/organize/posts/:id.json` | Pojedynczy post |
| POST | `/organize/posts.json` | Utworzenie posta |
| PATCH | `/organize/posts/:id.json` | Aktualizacja posta |
| DELETE | `/organize/posts/:id.json` | Usunięcie posta |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **organize**)

## Pola posta

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `title` | string | tak | Tytuł posta |
| `content` | string | nie | Treść posta (Markdown) |
| `team_id` | integer | nie | ID zespołu |
| `project_id` | integer | nie | ID projektu |
| `archived` | boolean | nie | Czy zarchiwizowany |
| `kind` | string | nie | Typ posta |

## Tworzenie posta

```
POST /organize/posts.json
Authorization: Bearer TOKEN
```

```json
{
  "post": {
    "title": "Podsumowanie sprintu 5",
    "content": "## Co zrobiliśmy\n\n- Wdrożenie nowego modułu\n- Naprawienie 12 bugów\n\n## Co planujemy\n\n- Optymalizacja wydajności",
    "team_id": 1,
    "project_id": 10
  }
}
```

## Aktualizacja posta

```
PATCH /organize/posts/:id.json
```

```json
{
  "post": {
    "title": "Podsumowanie sprintu 5 (zaktualizowane)",
    "archived": false
  }
}
```

## Błędy (422)

```json
{"title": ["nie może być puste"]}
```