[Intum Pomoc](https://intum.pl/pomoc.md) / [InConnector](https://intum.pl/pomoc/inconnector.md)

# Dobre praktyki

Kilka zasad, które oszczędzają czas przy pracy z Connect na dłuższą metę - zwłaszcza gdy z
kontem pracuje więcej niż jedna osoba.

> [!PATH]
> [InConnector](app:/connect)

## Ustal kod, zanim cokolwiek podepniesz {#kod}

**Kod** konektora i flow to jedyny sposób, w jaki inne elementy (crony, aplikacje, webhooki,
wywołania z zewnątrz) się do nich odwołują. Zmiana kodu po podłączeniu czegokolwiek zrywa to
powiązanie po cichu - nic nie krzyknie błędem, po prostu przestanie działać. Ustal kod od razu
przy zakładaniu i traktuj go jak stały identyfikator.

## Sięgaj po gotowy rodzaj, zanim zaczniesz pisać własny {#gotowe}

Zanim opiszesz [własny konektor](inconnector/connect-wlasny-konektor) wywołaniami, sprawdź [listę gotowych
rodzajów](inconnector/connect-gotowe-konektory) - dla popularnych usług (banki, sklepy, płatności,
księgowość) gotowy rodzaj oszczędza opisywanie wywołań i sam wie, jak obsłużyć błędy i
osobliwości danej usługi.

## Chroń hasłem to, co ważne {#haslo}

Konektor, który obsługuje płatności albo steruje czymś fizycznym, zabezpiecz hasłem (patrz
[Zabezpieczenia i uprawnienia](inconnector/connect-bezpieczenstwo-i-uprawnienia)) - zanim ktoś inny z
dostępem do konta zmieni go przez pomyłkę.

## Klucze i hasła zawsze przez Pola ukryte {#klucze}

Nigdy nie wpisuj klucza API ani hasła wprost w **Metody (JSON)** - trzymaj je w **Polach
ukrytych** i odwołuj się przez `{secret.nazwa}`, jak opisuje [Klucze API i hasła w
konektorze](inconnector/connect-klucze-i-hasla). Konfiguracja z kluczem wpisanym wprost wychodzi otwartym
tekstem wszędzie, gdzie widać ustawienia konektora.

## Loguj żądania tylko na czas diagnozy {#logowanie}

**Loguj żądania** włączaj, gdy faktycznie sprawdzasz, co przychodzi - i wyłączaj zaraz potem.
Zostawione włączone przy usłudze z dużym ruchem zapełnia listę Requestów w kilka godzin i traci
sens jako narzędzie diagnostyczne.

## Pamiętaj o retencji przy starych danych {#retencja}

Dane starsze niż 12 miesięcy bywają okrojone albo skasowane - jeśli integracja ma wracać do
starych zamówień czy faktur (korekty, reklamacje), zaplanuj to z wyprzedzeniem. Szczegóły w
[Stary proces albo obiekt nie ma pełnych danych](inconnector/connect-problemy-stary-proces-bez-danych).

## Opisuj, po co dany element istnieje {#opis}

Pole **Opis** przy konektorze i flow to jedyne miejsce na notatkę dla następnej osoby - skąd
wzięły się dane do logowania, po co dany element w ogóle stoi. Krótkie zdanie dziś oszczędza
pół godziny odgadywania za pół roku.