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.
Gdzie to znajdziesz
Ustal kod, zanim cokolwiek podepniesz
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
Zanim opiszesz własny konektor wywołaniami, sprawdź listę gotowych rodzajów - 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
Konektor, który obsługuje płatności albo steruje czymś fizycznym, zabezpiecz hasłem (patrz Zabezpieczenia i uprawnienia) - zanim ktoś inny z dostępem do konta zmieni go przez pomyłkę.
Klucze i hasła zawsze przez Pola ukryte
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. Konfiguracja z kluczem wpisanym wprost wychodzi otwartym
tekstem wszędzie, gdzie widać ustawienia konektora.
Loguj żądania tylko na czas diagnozy
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
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.
Opisuj, po co dany element istnieje
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.