Connectorens verktøy
Du finner hvert verktøy med virkning, grenser og parametere.
På denne siden
Finn riktig verktøy og dets parametere. Hvert hostingverktøy arbeider i nøyaktig ett Space.
Informasjon
Applikasjonen er koblet til TEISENDA-kontoen din, og forbindelsen er ikke avsluttet; fremgangsmåten står under Claude og ChatGPT.
For et hostingverktøy gjelder forbindelsen for Space som kallet oppgir. Du er medlem der, og det er ikke sperret.
Din rolle i Space tillater verktøyet.
Argumentet space bestemmer Space
Hvert hostingverktøy krever argumentet space: den tisifrede Space-ID-en. whoami tar ingen argumenter.
Applikasjonen skal velge Space fra whoami eller opplysningene dine og spørre hvis flere Spaces er aktuelle.
TEISENDA kontrollerer selv ved hvert kall om Space tilhører forbindelsen og du er medlem der. Verktøyet kjøres bare i dette ene Space.
Hvilken verdi godtar space ?
Et heltall med ti sifre eller en tekst med nøyaktig ti sifre. TEISENDA svarer på alt annet som om Space manglet, for eksempel et tall med færre eller flere sifre. Ti sifre som ikke er et Space i forbindelsen, besvares med meldingen om at Space ikke tilhører forbindelsen. Begge meldingene finnes under Verktøy for Spaces.
Resultatet fra et hostingverktøy oppgir Space først
Resultatet oppgir først Space-ID og visningsnavn. Kontroller disse opplysningene; ved feil Space skal applikasjonen stoppe i henhold til instruksjonene sine.
Ved Lagret, men ennå ikke overført til hostingnoden: er endringen lagret, men ennå ikke overført. Kontroller tilstanden senere med hosting_project_status .
Når er et resultat ikke en feil selv om noe gjenstår?
Noen resultater er ikke merket som feil: Verktøyet har gjort det det kunne, og oppgir hva som mangler. Dette gjelder når den oppgitte versjonen allerede er publisert, når domenets DNS ennå ikke er riktig, når et prosjekt er slettet, men hostingnoden ikke har bekreftet det, og for svaret fra et verktøy med to trinn som ber om bekreftelsessetningen.
Hva endrer et verktøy i TEISENDA, og hvor ser jeg det?
Hvert verktøy kaller de samme tjenestene som appens overflate, med de samme rettighetene og grensene. Et verktøy endrer TEISENDA på samme måte som om du hadde gjort det i overflaten.
Prosjektloggen registrerer endringer med kanalen Tilkoblet app der handlingen skriver en linje. Leseverktøy skriver ingen linje der. Ved skriving eller sletting av filer registrerer den bare at et nytt utkast er åpnet.
Rollen din tillater verktøyet
Eier, Administrator og Bruker kan kalle alle hostingverktøy. Lesetilgang kan bare bruke fem hostingverktøy som leser; listen står under Tillatelser.
Verktøylisten viser også verktøy rollen din ikke tillater. Rettigheten kontrolleres ved kallet.
Ingen hostingverktøy arbeider i et sperret Space
whoami lister fortsatt et sperret Space og merker det som sperret, men ingen hostingverktøy arbeider der. En forbindelse der alle Spaces er sperret, tilbyr applikasjonen bare whoami . Hva du kan gjøre, står under Verktøy for Spaces; mer om sperrer finnes under Forstå Spaces.
Merkene sier om et verktøy bare leser eller endrer noe
Merkene står ved verktøyet og i listen nedenfor.
| Merke | Betydning |
|---|---|
| «leser bare» | Verktøyet endrer ingenting, skriver ingen logglinje som noen ser i appen, og kan gjentas uten virkning. Dette gjelder sju hostingverktøy og whoami. |
| «endrer data» | Verktøyet endrer noe. Dette gjelder de øvrige 16 hostingverktøyene. |
| «sletter, overskriver eller endrer synlig innhold» | Verktøyet sletter, overskriver eller endrer det besøkende ser på et nettsted. Merket betyr ikke at et verktøy sletter; virkningen står i avsnittet for verktøyet. |
| «to trinn» | Verktøyet krever en bekreftelsessetning. |
Tre verktøy krever en bekreftelsessetning
hosting_delete_project, hosting_remove_domain og endringen til offentlig med hosting_set_visibility arbeider i to trinn: Uten confirm oppgir svaret konsekvensen og setningen; først et kall med denne setningen utfører handlingen.
Applikasjonen skal først innhente samtykket ditt. Kontroller prosjekt og Space; Tillatelser forklarer fremgangsmåten.
Advarsel
Alle andre verktøy arbeider ved første kall, også ved sletting, overskriving eller endring av nettstedet. Det er ikke garantert at applikasjonen spør.
Verktøyene bruker noen andre ord enn denne dokumentasjonen
Verktøyene er beskrevet på engelsk. De tyske svarene deres bruker noen andre ord enn dokumentasjonen.
| I tyske svar | I denne dokumentasjonen |
|---|---|
«Stand», «Deployment»; som parameter deploy |
Versjon. Verktøyene bruker også dette ordet om utkastet. |
«Deployment» når abonnementstypen teller; som felt deployments |
Publisering: Første publisering av en versjon bruker én. Å publisere en versjon som tidligere har vært publisert, på nytt bruker ingen. |
| «offener Stand» | Utkast: Filene kan fortsatt endres, og det er ikke publisert. Et prosjekt har maksimalt ett. |
| «abgeschlossen» | Ferdigstilt versjon: enhver kontrollert versjon som ikke lenger kan endres, enten den er publisert eller ikke. |
| «fertig, aber nicht veröffentlicht» | Ferdig versjon: en ferdigstilt versjon som aldri har vært publisert. |
| «automatic address» i verktøybeskrivelsene | TEISENDA-adresse: adressen TEISENDA selv gir prosjektet. |
Hvert verktøy har sitt avsnitt på en underside
Navnet fører til verktøyets avsnitt med parametere. Titlene er engelske.
| Verktøy | Tittel | Egenskaper |
|---|---|---|
whoami | Show user and spaces | leser bare |
hosting_list_projects | List projects | leser bare |
hosting_create_project | Create project | endrer data |
hosting_project_status | Project status | leser bare |
hosting_rename_project | Rename project | endrer data |
hosting_set_offline | Take project offline or online | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_delete_project | Delete project | endrer datasletter, overskriver eller endrer synlig innholdto trinn |
hosting_put_files | Write files | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_delete_files | Delete files | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_list_files | List files | leser bare |
hosting_read_file | Read file | leser bare |
hosting_create_upload | Create upload link | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_deploy | Publish deployment | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_deploy_status | Deployment status | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_list_deploys | List deployments | leser bare |
hosting_rollback | Roll back deployment | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_add_domain | Add domain | endrer data |
hosting_check_domain | Check domain | endrer data |
hosting_set_primary_domain | Set primary domain | endrer datasletter, overskriver eller endrer synlig innhold |
hosting_remove_domain | Remove domain | endrer datasletter, overskriver eller endrer synlig innholdto trinn |
hosting_get_visibility | Get visibility | leser bare |
hosting_set_visibility | Set visibility | endrer datasletter, overskriver eller endrer synlig innholdto trinn |
hosting_list_redirects | List redirects | leser bare |
hosting_set_redirects | Set redirects | endrer datasletter, overskriver eller endrer synlig innhold |
Noen grenser og meldinger gjelder for hvert kall
Et kall varer maksimalt to minutter; en forespørsel er maksimalt 8 MB. Andre grenser og feilhjelpen gjelder for alle verktøy.
Hva abonnementstypen i Space begrenser, står ved verktøyene for prosjekter, domener, filer og publisering; abonnementstypene beskrives under Free og Max.