Własne konektory

Własny konektor to usługa, którą opisujesz sam: dowolne API w internecie, które przyjmuje klucz. Gdy go utworzysz, twoje aplikacje używają go jak każdego konektora z listy, przez Setherion, a klucz zostaje na naszych serwerach.

Naciśnij + w prawym górnym rogu strony Connectors, potem Custom connector i wypełnij:

• Details. Display name, Short description na listę, dłuższy Description, Category i opcjonalny adres dokumentacji.
• Authentication. Jak podróżuje klucz: jako Bearer token, API key in a header (podajesz nazwę nagłówka), API key in the address (podajesz nazwę parametru) albo Username and password. Możesz też nazwać to, o co pytani są ludzie, na przykład „Hasło”. What requests to this API will look like pokazuje to na bieżąco, gdy wybierasz. Potem API base URL, od którego zaczyna się każde żądanie, i Test request: proste wywołanie, które bez ważnego klucza kończy się błędem, na przykład takie, które zwraca bieżące konto.
• Who may use it. Only your app's team (domyślnie), Visitors can read lub Anybody, a potem rodzaje żądań, które aplikacje mogą wysyłać: GET czyta, pozostałe coś zmieniają. Przy Visitors can read każdy, kto otworzy aplikację, może czytać, a zmieniać może tylko zespół. Przy Anybody każdy może wykonać każde wywołanie, na które zezwolisz, a wywołania są ściślej ograniczane dla każdego odwiedzającego, więc wybierz tę opcję tylko dla API zbudowanego z takim zamiarem.
• Agent knowledge. Opcjonalnie, ale warto to napisać: ścieżki, dla każdej żądanie i odpowiedź oraz wszystko, w czym łatwo się pomylić. Setherion czyta to, gdy buduje twoje aplikacje. Bez tego Setherion musi zgadywać ścieżki, a zgadnięcie może być błędne: powiedz na przykład, która ścieżka zwraca twoje własne konto. Nigdy nie wklejaj tu klucza.

W formularzu nie ma żadnego klucza. Create otwiera stronę konektora, na której dodajesz klucz, naciskasz Test connection i łączysz, tak jak w przypadku każdej innej usługi. Edit i Delete też są na tej stronie. Usunięcie konektora usuwa także jego klucz, a aplikacje, które go używają, od razu przestają się z nim łączyć.

Poproś. Gdy konektor jest połączony i zaznaczony dla aplikacji, poproś o niego po nazwie: „Pokaż na panelu moje otwarte projekty z Acme.” „Dodaj przycisk, który tworzy zadanie w Acme.”

• API base URL musi zaczynać się od https:// i leżeć w publicznym internecie. Adres w sieci prywatnej, adres IP lub adres z portem innym niż 443 zostanie odrzucony, przy zapisie i jeszcze raz przy każdym wywołaniu.
• Własne konektory należą do ciebie: nie są udostępniane członkom przestrzeni roboczej zespołu, a przestrzeń robocza, która wylicza konektory dozwolone dla jej aplikacji, je pomija.
• Możesz mieć ich do 25.
• Dla pojedynczego klucza, którego potrzebuje jedna aplikacja, mogą wystarczyć Klucze i sekrety.