Referencja narzędzi Connectora
Znajdź narzędzie potrzebne do pracy z hostingiem.
Na tej stronie
Znajdź narzędzie i parametry do pracy w wybranym Space. Space to wspólny obszar roboczy w aplikacji.
Każde narzędzie hostingowe pracuje w dokładnie jednym Space.
Informacja
Aplikacja jest połączona z Twoim kontem TEISENDA, a połączenie nie jest zakończone. Kroki opisano dla Claude i ChatGPT.
Dla narzędzia hostingowego połączenie obejmuje Space podany przez wywołanie. Jesteś jego członkiem i Space nie jest zablokowany.
Twoja rola w Space pozwala na użycie narzędzia.
Argument space określa Space
Każde narzędzie hostingowe wymaga argumentu space: dziesięciocyfrowego Space-ID. whoami nie przyjmuje argumentów.
Aplikacja ma wybrać Space z whoami lub Twojej informacji i zapytać przy kilku możliwych Spaces.
TEISENDA sama sprawdza przy każdym wywołaniu, czy Space należy do połączenia i czy jesteś jego członkiem. Narzędzie działa tylko w tym jednym Space.
Jaką wartość przyjmuje space?
Liczbę całkowitą z dziesięcioma cyframi lub tekst z dokładnie dziesięciu cyfr. Na każdą inną wartość TEISENDA odpowiada jak na brak Space, na przykład na liczbę z mniejszą lub większą liczbą cyfr. Na dziesięć cyfr, które nie są Space połączenia, TEISENDA odpowiada informacją, że Space nie należy do połączenia. Oba komunikaty znajdziesz przy narzędziu do Spaces.
Wynik narzędzia hostingowego podaje najpierw Space
Wynik podaje najpierw Space-ID i nazwę wyświetlaną. Sprawdź te informacje; zgodnie z instrukcjami aplikacja ma się zatrzymać przy niewłaściwym Space.
Przy Zapisano, ale jeszcze nie przesłano do węzła hostingowego: zmiana jest zapisana, ale jeszcze nie przesłana. Sprawdź później stan za pomocą hosting_project_status.
Kiedy wynik nie jest błędem, choć coś jeszcze oczekuje?
Niektóre wyniki nie są oznaczone jako błąd: narzędzie zrobiło, co mogło, i podaje, czego brakuje. Dotyczy to już opublikowanej wersji, nieprawidłowego jeszcze DNS domeny, usuniętego projektu bez potwierdzenia węzła hostingowego oraz odpowiedzi dwustopniowego narzędzia, która prosi o zdanie potwierdzające.
Co narzędzie zmienia w TEISENDA i gdzie to widzę?
Każde narzędzie wywołuje te same usługi co interfejs aplikacji, z tymi samymi uprawnieniami i limitami. Zmiana dokonana przez narzędzie jest w TEISENDA taka sama jak wykonana w interfejsie.
Dziennik projektu zapisuje zmiany z kanałem Połączona aplikacja, jeśli działanie zapisuje wiersz. Narzędzia czytające nie zapisują tam wiersza. Przy zapisywaniu lub usuwaniu plików zapisuje tylko otwarcie nowego szkicu.
Twoja rola pozwala na użycie narzędzia
Właściciel, Administrator i Użytkownik mogą wywoływać wszystkie narzędzia hostingowe. Tylko do odczytu mogą używać tylko pięciu narzędzi hostingowych do odczytu; lista znajduje się na stronie Uprawnienia.
Lista narzędzi pokazuje także narzędzia niedozwolone dla Twojej roli. Uprawnienia są sprawdzane przy wywołaniu.
W zablokowanym Space nie działa żadne narzędzie hostingowe
whoami nadal wymienia zablokowany Space i oznacza go jako zablokowany, ale żadne narzędzie hostingowe w nim nie działa. Połączenie, którego wszystkie Spaces są zablokowane, udostępnia aplikacji tylko whoami. Rozwiązanie znajdziesz przy narzędziu do Spaces; więcej o blokadach: Poznaj Spaces.
Oznaczenia mówią, czy narzędzie tylko czyta, czy coś zmienia
Oznaczenia znajdują się przy narzędziu i na poniższej liście.
| Oznaczenie | Znaczenie |
|---|---|
| „tylko odczyt” | Narzędzie niczego nie zmienia, nie zapisuje wiersza dziennika widocznego w aplikacji i można je powtarzać bez skutków. Dotyczy to siedmiu narzędzi hostingowych i whoami. |
| „zmienia dane” | Narzędzie coś zmienia. Dotyczy to pozostałych 16 narzędzi hostingowych. |
| „usuwa, nadpisuje lub zmienia to, co widać” | Narzędzie usuwa, zastępuje lub zmienia to, co widzą odwiedzający witrynę. Oznaczenie nie oznacza, że narzędzie usuwa; działanie opisano w jego sekcji. |
| „dwa kroki” | Narzędzie wymaga zdania potwierdzającego. |
Trzy narzędzia wymagają zdania potwierdzającego
hosting_delete_project, hosting_remove_domain i zmiana na publiczną za pomocą hosting_set_visibility działają w dwóch krokach: bez confirm odpowiedź podaje skutek i zdanie; dopiero wywołanie z tym zdaniem wykonuje działanie.
Aplikacja ma najpierw uzyskać Twoją zgodę. Sprawdź projekt i Space; uprawnienia opisują procedurę.
Uwaga
Wszystkie pozostałe narzędzia działają przy pierwszym wywołaniu, także przy usuwaniu, zastępowaniu lub zmianie witryny. Pytanie aplikacji o potwierdzenie nie jest zagwarantowane.
Narzędzia nazywają niektóre rzeczy inaczej niż ta dokumentacja
Narzędzia są opisane po angielsku. Ich niemieckie odpowiedzi nazywają niektóre rzeczy inaczej niż ta dokumentacja.
| W niemieckich odpowiedziach | W tej dokumentacji |
|---|---|
„Stand”, „Deployment”; jako parametr deploy |
Wersja. Narzędzia tak nazywają także szkic. |
„Deployment”, gdy plan liczy; jako pole deployments |
Publikacja: pierwsze opublikowanie wersji zużywa jedną. Ponowne opublikowanie wcześniej opublikowanej wersji nie zużywa publikacji. |
| „offener Stand” | Szkic: jego pliki można nadal zmieniać i nie jest opublikowany. Projekt ma najwyżej jeden. |
| „abgeschlossen” | Ukończona wersja: każda sprawdzona wersja, której nie można już zmienić, opublikowana lub nie. |
| „fertig, aber nicht veröffentlicht” | Gotowa wersja: ukończona wersja, która nigdy nie była opublikowana. |
| „automatic address” w opisach narzędzi | Adres TEISENDA: adres nadawany projektowi przez TEISENDA. |
Każde narzędzie ma sekcję na podstronie
Nazwa prowadzi do sekcji narzędzia z parametrami. Tytuły są po angielsku.
| Narzędzie | Tytuł | Właściwości |
|---|---|---|
whoami | Show user and spaces | tylko odczyt |
hosting_list_projects | List projects | tylko odczyt |
hosting_create_project | Create project | zmienia dane |
hosting_project_status | Project status | tylko odczyt |
hosting_rename_project | Rename project | zmienia dane |
hosting_set_offline | Take project offline or online | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_delete_project | Delete project | zmienia daneusuwa, nadpisuje lub zmienia to, co widaćdwa kroki |
hosting_put_files | Write files | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_delete_files | Delete files | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_list_files | List files | tylko odczyt |
hosting_read_file | Read file | tylko odczyt |
hosting_create_upload | Create upload link | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_deploy | Publish deployment | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_deploy_status | Deployment status | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_list_deploys | List deployments | tylko odczyt |
hosting_rollback | Roll back deployment | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_add_domain | Add domain | zmienia dane |
hosting_check_domain | Check domain | zmienia dane |
hosting_set_primary_domain | Set primary domain | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
hosting_remove_domain | Remove domain | zmienia daneusuwa, nadpisuje lub zmienia to, co widaćdwa kroki |
hosting_get_visibility | Get visibility | tylko odczyt |
hosting_set_visibility | Set visibility | zmienia daneusuwa, nadpisuje lub zmienia to, co widaćdwa kroki |
hosting_list_redirects | List redirects | tylko odczyt |
hosting_set_redirects | Set redirects | zmienia daneusuwa, nadpisuje lub zmienia to, co widać |
Niektóre limity i komunikaty obowiązują przy każdym wywołaniu
Wywołanie trwa najwyżej dwie minuty; żądanie ma najwyżej 8 MB. Dodatkowe limity i pomoc przy błędach obowiązują dla wszystkich narzędzi.
Ograniczenia planu Space znajdziesz przy narzędziach do projektów, domen, plików i publikowania; zakres planów opisują Plany Free i Max.