Toolreferentie van de Connector
Vind de tool voor je taak en controleer de parameters.
Op deze pagina
Een Space is een gedeelde werkruimte in de app.
Vind de juiste tool en de parameters. Elke hostingtool werkt in precies één Space.
Informatie
De toepassing is verbonden met je TEISENDA-account en de verbinding is niet beëindigd; hoe dat gaat, lees je bij Claude en ChatGPT.
Voor een hostingtool geldt de verbinding voor de Space die de aanroep noemt. Je bent daar lid en de Space is niet geblokkeerd.
Je rol in de Space staat de tool toe.
Het argument space bepaalt de Space
Elke hostingtool vereist het argument space: de tiencijferige Space-ID. whoami accepteert geen argumenten.
De toepassing moet de Space uit whoami of jouw opgave kiezen en bij meerdere mogelijke Spaces om verduidelijking vragen.
TEISENDA controleert zelf bij elke aanroep of de Space bij de verbinding hoort en of je er lid bent. De tool werkt alleen in deze ene Space.
Welke waarde accepteert space?
Een geheel getal met tien cijfers of een tekst met precies tien cijfers. Al het andere beantwoordt TEISENDA alsof de Space ontbreekt, bijvoorbeeld een getal met minder of meer cijfers. Bij tien cijfers die geen Space van de verbinding aanduiden, antwoordt TEISENDA met de melding dat de Space niet bij de verbinding hoort. Beide meldingen staan bij de tool voor Spaces.
Het resultaat van een hostingtool noemt eerst de Space
Het resultaat noemt eerst de Space-ID en de weergavenaam. Controleer deze gegevens; bij een verkeerde Space moet de toepassing volgens haar instructies stoppen.
Bij Opgeslagen, maar nog niet overgedragen aan het hostingknooppunt: is de wijziging opgeslagen maar nog niet overgedragen. Controleer later met hosting_project_status de toestand.
Wanneer is een resultaat geen fout, hoewel er nog iets openstaat?
Sommige resultaten zijn niet als fout gemarkeerd: de tool heeft gedaan wat mogelijk was en vermeldt wat ontbreekt. Dit geldt als de genoemde versie al gepubliceerd is, als het DNS van een domein nog niet klopt, als een project verwijderd is maar het hostingknooppunt dit nog niet heeft bevestigd, en bij het antwoord van een tool met twee stappen dat om de bevestigingszin vraagt.
Wat wijzigt een tool in TEISENDA en waar zie ik dat?
Elke tool roept dezelfde diensten aan als de app-interface, met dezelfde rechten en limieten. Wat een tool wijzigt, is in TEISENDA gewijzigd alsof je dit via de interface hebt gedaan.
Het projectlogboek legt wijzigingen vast met het kanaal Gekoppelde app, als de handeling een regel schrijft. Lezende tools schrijven daar geen regel. Bij het schrijven of verwijderen van bestanden wordt alleen vastgelegd dat een nieuw concept is geopend.
Je rol staat de tool toe
Eigenaar, Beheerder en Gebruiker mogen alle hostingtools aanroepen. Alleen-lezen mogen alleen vijf lezende hostingtools gebruiken; de lijst staat onder Machtigingen.
De toollijst toont ook tools die je rol niet toestaat. Het recht wordt bij de aanroep gecontroleerd.
In een geblokkeerde Space werkt geen enkele hostingtool
whoami blijft een geblokkeerde Space vermelden en markeert deze als geblokkeerd, maar geen enkele hostingtool werkt daarin. Een verbinding waarvan alle Spaces zijn geblokkeerd, biedt de toepassing alleen whoami aan. Wat je daaraan doet, lees je bij de tool voor Spaces; meer over blokkeringen lees je onder Spaces begrijpen.
De labels geven aan of een tool alleen leest of iets wijzigt
De labels staan bij de tool en in de onderstaande lijst.
| Label | Betekenis |
|---|---|
| ‘leest alleen’ | De tool wijzigt niets, schrijft geen logboekregel die iemand in de app ziet en kan zonder gevolgen worden herhaald. Dit geldt voor zeven hostingtools en voor whoami. |
| ‘wijzigt gegevens’ | De tool wijzigt iets. Dit geldt voor de overige 16 hostingtools. |
| ‘verwijdert, overschrijft of wijzigt iets zichtbaars’ | De tool verwijdert, overschrijft of wijzigt wat bezoekers van een website zien. Het label betekent niet dat een tool verwijdert; wat deze doet, staat in het betreffende onderdeel. |
| ‘twee stappen’ | De tool vereist een bevestigingszin. |
Drie tools vereisen een bevestigingszin
hosting_delete_project, hosting_remove_domain en de overstap naar openbaar met hosting_set_visibility werken in twee stappen: zonder confirm noemt het antwoord het gevolg en de zin; pas een aanroep met deze zin voert de handeling uit.
De toepassing moet eerst je toestemming vragen. Controleer het project en de Space; Machtigingen licht de procedure toe.
Let op
Alle andere tools voeren hun handeling bij de eerste aanroep uit, ook bij het verwijderen, overschrijven of wijzigen van de website. Een bevestigingsvraag van de toepassing is niet gegarandeerd.
De tools noemen sommige dingen anders dan deze documentatie
De tools hebben Engelstalige beschrijvingen. Hun Duitse antwoorden gebruiken voor sommige dingen andere woorden dan deze documentatie.
| In Duitse antwoorden | In deze documentatie |
|---|---|
‘Stand’, ‘Deployment’; als parameter deploy |
Versie. De tools noemen het concept ook zo. |
‘Deployment’, als het abonnement telt; als veld deployments |
Publicatie: de eerste publicatie van een versie verbruikt er één. Het opnieuw publiceren van een eerder gepubliceerde versie verbruikt er geen. |
| ‘offener Stand’ | Concept: de bestanden kunnen nog worden gewijzigd en het is niet gepubliceerd. Een project heeft er maximaal één. |
| ‘abgeschlossen’ | Afgesloten versie: elke gecontroleerde versie die niet meer kan worden gewijzigd, ongeacht of deze is gepubliceerd. |
| ‘fertig, aber nicht veröffentlicht’ | Klaargemaakte versie: een afgesloten versie die nog nooit is gepubliceerd. |
| ‘automatic address’ in de toolbeschrijvingen | TEISENDA-adres: het adres dat TEISENDA zelf aan het project geeft. |
Elke tool heeft een onderdeel op een onderliggende pagina
De naam leidt naar het onderdeel van de tool met de parameters. De titels zijn Engelstalig.
| Tool | Titel | Eigenschappen |
|---|---|---|
whoami | Show user and spaces | alleen lezen |
hosting_list_projects | List projects | alleen lezen |
hosting_create_project | Create project | wijzigt gegevens |
hosting_project_status | Project status | alleen lezen |
hosting_rename_project | Rename project | wijzigt gegevens |
hosting_set_offline | Take project offline or online | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_delete_project | Delete project | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoudtwee stappen |
hosting_put_files | Write files | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_delete_files | Delete files | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_list_files | List files | alleen lezen |
hosting_read_file | Read file | alleen lezen |
hosting_create_upload | Create upload link | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_deploy | Publish deployment | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_deploy_status | Deployment status | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_list_deploys | List deployments | alleen lezen |
hosting_rollback | Roll back deployment | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_add_domain | Add domain | wijzigt gegevens |
hosting_check_domain | Check domain | wijzigt gegevens |
hosting_set_primary_domain | Set primary domain | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
hosting_remove_domain | Remove domain | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoudtwee stappen |
hosting_get_visibility | Get visibility | alleen lezen |
hosting_set_visibility | Set visibility | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoudtwee stappen |
hosting_list_redirects | List redirects | alleen lezen |
hosting_set_redirects | Set redirects | wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud |
Sommige limieten en meldingen gelden voor elke aanroep
Een aanroep duurt maximaal twee minuten; een aanvraag is maximaal 8 MB. Verdere limieten en de hulp bij fouten gelden voor alle tools.
Wat het abonnement van de Space beperkt, staat bij de tools voor projecten, domeinen, bestanden en publiceren; de abonnementen staan onder Free en Max.