[Intum](https://intum.fr/aide.md) / [Konto](https://intum.fr/aide/konto.md)

# [Domeny](https://intum.fr/aide/konto/domeny.md) | [API](#api)

## Domeny

Domeny pozwalają używać własnych adresów internetowych zamiast domyślnej subdomeny systemowej.

## Dodawanie domeny

Aby podłączyć własną domenę, dodaj ją w ustawieniach konta i skonfiguruj rekordy DNS:

- **Rekord A** — kieruje domenę na serwer aplikacji. Wymagany, aby konto było dostępne pod własnym adresem URL
- **Rekord MX** — kieruje pocztę na serwer mailowy. Wymagany do odbierania e-maili na własnej domenie

## Walidacja

Po dodaniu domeny system sprawdza konfigurację DNS:
- **Walidacja A** — potwierdza, że domena wskazuje na właściwy serwer
- **Walidacja MX** — potwierdza, że poczta jest prawidłowo skierowana

Domena staje się aktywna dopiero po pomyślnej walidacji. Domeny systemowe (np. `intum.pl`) są chronione i nie mogą być walidowane.

## Domena główna

Jedna z domen może być ustawiona jako **główna** — używana do budowania adresów URL konta (np. linki w e-mailach, przekierowania).

## Przypisanie do zasobów

Domenę można powiązać z:
- **Witryną CMS** — domena prowadzi do konkretnej witryny
- **Bazą wiedzy** — domena wyświetla bazę wiedzy

Jedno konto może mieć wiele domen, a każda domena może obsługiwać inny zasób.

---

## 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**

## API — Domeny

### Lista domen

```
GET /account/domains.json
```

### Pobranie domeny

```
GET /account/domains/:id.json
```

### Tworzenie domeny

```
POST /account/domains.json
```

**Parametry:**

- `domain[domain]` — adres domeny (np. `example.com`)
- `domain[description]` — opis
- `domain[kind]` — typ
- `domain[active]` — boolean
- `domain[subject_type]` — typ zasobu (np. `Cms::Site`, `Kb::KnowledgeBase`)
- `domain[subject_id]` — ID powiązanego zasobu

### Aktualizacja domeny

```
PATCH /account/domains/:id.json
```

**Parametry:** `domain[domain]`, `domain[description]`, `domain[active]`

### Usunięcie domeny

```
DELETE /account/domains/:id.json
```

### Walidacja domeny

```
GET /account/domains/:id/validate?type=TYPE
```

**Parametry:**

- `type` — typ walidacji: `a` (rekord A) lub `mx` (rekord MX)
- `t` — token walidacyjny