Tools des Connectors
Du findest jedes Tool mit Wirkung, Grenzen und Parametern.
Auf dieser Seite
Finde das passende Tool und seine Parameter. Jedes Hosting-Tool arbeitet in genau einem Space.
Hinweis
Die Anwendung ist mit deinem TEISENDA-Konto verbunden, und die Verbindung ist nicht beendet; wie, steht bei Claude und ChatGPT.
Für ein Hosting-Tool gilt die Verbindung für den Space, den der Aufruf nennt. Du bist dort Mitglied, und er ist nicht gesperrt.
Deine Rolle im Space erlaubt das Tool.
Das Argument space bestimmt den Space
Jedes Hosting-Tool verlangt das Argument space: die zehnstellige Space-ID. whoami nimmt kein Argument.
Die Anwendung soll den Space aus whoami oder deiner Angabe wählen und bei mehreren möglichen Spaces nachfragen.
Ob der Space zur Verbindung gehört und du dort Mitglied bist, prüft TEISENDA bei jedem Aufruf selbst. Das Tool läuft nur in diesem einen Space.
Welchen Wert nimmt space an?
Eine ganze Zahl mit zehn Stellen oder einen Text aus genau zehn Ziffern. Alles andere beantwortet TEISENDA wie einen fehlenden Space, etwa eine Zahl mit weniger oder mehr Stellen. Zehn Ziffern, die kein Space der Verbindung sind, beantwortet TEISENDA mit der Meldung, dass der Space nicht zur Verbindung gehört. Beide Meldungen stehen beim Tool für Spaces.
Das Ergebnis eines Hosting-Tools nennt zuerst den Space
Das Ergebnis nennt zuerst Space-ID und Anzeigename. Prüfe diese Angaben; bei falschem Space soll die Anwendung nach ihren Anweisungen anhalten.
Bei Gespeichert, aber noch nicht zum Hosting-Knoten übertragen: ist die Änderung gespeichert, aber noch nicht übertragen. Prüfe später mit hosting_project_status den Stand.
Wann ist ein Ergebnis kein Fehler, obwohl noch etwas aussteht?
Manche Ergebnisse sind nicht als Fehler markiert: Das Tool hat getan, was es konnte, und sagt, was fehlt. Das gilt, wenn die genannte Version schon veröffentlicht ist, wenn das DNS einer Domain noch nicht stimmt, wenn ein Projekt gelöscht ist, der Hosting-Knoten das aber noch nicht bestätigt hat, und für die Antwort eines zweistufigen Tools, die nach dem Bestätigungssatz fragt.
Was ändert ein Tool in TEISENDA, und wo sehe ich es?
Jedes Tool ruft dieselben Dienste auf wie die Oberfläche der App, mit denselben Rechten und Grenzen. Was ein Tool ändert, ist in TEISENDA so geändert, als hättest du es in der Oberfläche getan.
Das Protokoll des Projekts vermerkt Änderungen mit dem Kanal Verbundene Anwendung, wo der Vorgang eine Zeile schreibt. Lesende Tools schreiben dort keine Zeile. Beim Schreiben oder Löschen von Dateien vermerkt es nur, dass ein neuer Entwurf geöffnet ist.
Deine Rolle erlaubt das Tool
Inhaber, Administrator und Anwender dürfen alle Hosting-Tools aufrufen. Lesend dürfen nur fünf lesende Hosting-Tools nutzen; die Liste steht unter Berechtigungen.
Die Tool-Liste zeigt auch Tools, die deine Rolle nicht erlaubt. Das Recht wird beim Aufruf geprüft.
In einem gesperrten Space arbeitet kein Hosting-Tool
whoami führt einen gesperrten Space weiter auf und kennzeichnet ihn als gesperrt, aber kein Hosting-Tool arbeitet darin. Eine Verbindung, deren Spaces alle gesperrt sind, bietet der Anwendung nur whoami an. Was du dagegen tust, steht beim Tool für Spaces; mehr zu Sperren steht unter Spaces verstehen.
Die Marken sagen, ob ein Tool nur liest oder etwas ändert
Die Marken stehen am Tool und in der Liste unten.
| Marke | Bedeutung |
|---|---|
| „liest nur“ | Das Tool ändert nichts, schreibt keine Protokollzeile, die jemand in der App sieht, und lässt sich ohne Wirkung wiederholen. Das gilt für sieben Hosting-Tools und für whoami. |
| „ändert Daten“ | Das Tool ändert etwas. Das gilt für die übrigen 16 Hosting-Tools. |
| „löscht, überschreibt oder ändert Sichtbares“ | Das Tool löscht, überschreibt oder ändert, was Besucher einer Website sehen. Die Marke heißt nicht, dass ein Tool löscht; was es tut, steht in seinem Abschnitt. |
| „zwei Schritte“ | Das Tool verlangt einen Bestätigungssatz. |
Drei Tools verlangen einen Bestätigungssatz
hosting_delete_project, hosting_remove_domain und der Wechsel zu öffentlich mit hosting_set_visibility arbeiten in zwei Schritten: Ohne confirm nennt die Antwort die Folge und den Satz; erst ein Aufruf mit diesem Satz führt die Aktion aus.
Die Anwendung soll zuerst deine Zustimmung einholen. Prüfe Projekt und Space; die Berechtigungen erklären das Verfahren.
Achtung
Alle anderen Tools arbeiten beim ersten Aufruf, auch beim Löschen, Überschreiben oder Ändern der Website. Eine Rückfrage der Anwendung ist nicht zugesichert.
Die Tools benennen manches anders als diese Doku
Die Tools sind englisch beschrieben. Ihre deutschen Antworten benennen manches anders als die Doku.
| In deutschen Antworten | In dieser Doku |
|---|---|
„Stand“, „Deployment“; als Parameter deploy |
Version. Die Tools nennen auch den Entwurf so. |
„Deployment“, wo der Tarif zählt; als Feld deployments |
Veröffentlichung: Eine Version zum ersten Mal zu veröffentlichen verbraucht eine. Eine Version erneut zu veröffentlichen, die schon einmal veröffentlicht war, verbraucht keine. |
| „offener Stand“ | Entwurf: Seine Dateien lassen sich noch ändern, und veröffentlicht ist er nicht. Ein Projekt hat höchstens einen. |
| „abgeschlossen“ | Abgeschlossene Version: jede geprüfte Version, die sich nicht mehr ändern lässt, ob veröffentlicht oder nicht. |
| „fertig, aber nicht veröffentlicht“ | Fertige Version: eine abgeschlossene Version, die noch nie veröffentlicht war. |
| „automatic address“ in den Beschreibungen der Tools | TEISENDA-Adresse: die Adresse, die TEISENDA dem Projekt selbst gibt. |
Jedes Tool hat seinen Abschnitt auf einer Unterseite
Der Name führt zum Abschnitt des Tools mit seinen Parametern. Die Titel sind englisch.
| Tool | Titel | Eigenschaften |
|---|---|---|
whoami | Show user and spaces | liest nur |
hosting_list_projects | List projects | liest nur |
hosting_create_project | Create project | ändert Daten |
hosting_project_status | Project status | liest nur |
hosting_rename_project | Rename project | ändert Daten |
hosting_set_offline | Take project offline or online | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_delete_project | Delete project | ändert Datenlöscht, überschreibt oder ändert Sichtbareszwei Schritte |
hosting_put_files | Write files | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_delete_files | Delete files | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_list_files | List files | liest nur |
hosting_read_file | Read file | liest nur |
hosting_create_upload | Create upload link | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_deploy | Publish deployment | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_deploy_status | Deployment status | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_list_deploys | List deployments | liest nur |
hosting_rollback | Roll back deployment | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_add_domain | Add domain | ändert Daten |
hosting_check_domain | Check domain | ändert Daten |
hosting_set_primary_domain | Set primary domain | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
hosting_remove_domain | Remove domain | ändert Datenlöscht, überschreibt oder ändert Sichtbareszwei Schritte |
hosting_get_visibility | Get visibility | liest nur |
hosting_set_visibility | Set visibility | ändert Datenlöscht, überschreibt oder ändert Sichtbareszwei Schritte |
hosting_list_redirects | List redirects | liest nur |
hosting_set_redirects | Set redirects | ändert Datenlöscht, überschreibt oder ändert Sichtbares |
Manche Grenzen und Meldungen gelten für jeden Aufruf
Ein Aufruf dauert höchstens zwei Minuten; eine Anfrage ist höchstens 8 MB groß. Weitere Grenzen und die Fehlerhilfe gelten für alle Tools.
Was der Tarif des Space begrenzt, steht bei den Tools für Projekte, Domains, Dateien und zum Veröffentlichen; die Tarife beschreibt Tarife Free und Max.