Nástroje Connectoru
Najděte každý nástroj s účinkem, limity a parametry.
Na této stránce
Najděte vhodný nástroj a jeho parametry. Každý nástroj hostingu pracuje právě v jednom Space.
Informace
Aplikace je připojená k vašemu účtu TEISENDA a připojení není ukončené; postup najdete u Claude a ChatGPT.
Pro nástroj hostingu platí připojení pro Space uvedený ve volání. Jste jeho členem a není zablokovaný.
Vaše role ve Space dovoluje nástroj.
Argument space určuje Space
Každý nástroj hostingu vyžaduje argument space: desetimístné Space-ID. whoami nepřijímá argument.
Aplikace má vybrat Space z whoami nebo vašeho zadání a při více možných Spaces se zeptat.
TEISENDA při každém volání sama ověřuje, zda Space patří k připojení a jste jeho členem. Nástroj pracuje jen v tomto jednom Space.
Jakou hodnotu přijímá space?
Celé desetimístné číslo nebo text z přesně deseti číslic. Na vše ostatní TEISENDA odpovídá stejně jako na chybějící Space, například na číslo s méně nebo více číslicemi. Na deset číslic, které nejsou Space připojení, odpovídá zprávou, že Space k připojení nepatří. Obě zprávy uvádí nástroj pro Spaces.
Výsledek nástroje hostingu uvádí nejprve Space
Výsledek nejprve uvádí Space-ID a zobrazovaný název. Ověřte tyto údaje; při nesprávném Space má aplikace podle pokynů zastavit.
Při Uloženo, ale ještě nepřeneseno na hostingový uzel: je změna uložená, ale ještě není přenesená. Později ověřte stav pomocí hosting_project_status.
Kdy výsledek není chybou, i když něco ještě čeká?
Některé výsledky nejsou označené jako chyba: nástroj udělal, co mohl, a uvádí, co chybí. Platí to, pokud už je uvedená verze publikovaná, DNS domény ještě není správné, projekt je smazaný, ale hostingový uzel to ještě nepotvrdil, a u odpovědi dvoukrokového nástroje žádající potvrzovací větu.
Co nástroj mění v TEISENDA a kde to vidím?
Každý nástroj volá stejné služby jako rozhraní aplikace se stejnými oprávněními a limity. Změna nástroje platí v TEISENDA stejně jako změna provedená v rozhraní.
Záznam změn projektu uvádí změny s kanálem Připojená aplikace, pokud operace zapisuje řádek. Nástroje pro čtení tam řádek nezapisují. Při zápisu nebo mazání souborů zaznamenává jen otevření nového konceptu.
Vaše role dovoluje nástroj
Vlastník, Administrátor a Uživatel mohou volat všechny nástroje hostingu. Pouze pro čtení mohou používat jen pět nástrojů hostingu pro čtení; seznam uvádí návod Oprávnění.
Seznam nástrojů zobrazuje i nástroje nepovolené pro vaši roli. Oprávnění se ověřuje při volání.
Ve zablokovaném Space nepracuje žádný nástroj hostingu
whoami nadále uvádí zablokovaný Space a označuje ho jako zablokovaný, ale žádný nástroj hostingu v něm nepracuje. Připojení, jehož všechny Spaces jsou zablokované, nabízí aplikaci jen whoami. Nápravu vysvětluje nástroj pro Spaces; více o blokování uvádí návod Porozumět Spaces.
Označení uvádějí, zda nástroj jen čte, nebo mění data
Označení jsou u nástroje a v seznamu níže.
| Označení | Význam |
|---|---|
| „pouze čte“ | Nástroj nic nemění, nezapisuje řádek záznamu viditelný v aplikaci a lze ho opakovat bez účinku. Platí to pro sedm nástrojů hostingu a whoami. |
| „mění údaje“ | Nástroj provádí změnu. Platí to pro zbývajících 16 nástrojů hostingu. |
| „maže, přepisuje nebo mění viditelný obsah“ | Nástroj maže, přepisuje nebo mění obsah viditelný návštěvníkům webu. Označení neznamená, že nástroj maže; jeho operaci popisuje příslušná část. |
| „dva kroky“ | Nástroj vyžaduje potvrzovací větu. |
Tři nástroje vyžadují potvrzovací větu
hosting_delete_project, hosting_remove_domain a přechod na veřejný web pomocí hosting_set_visibility pracují ve dvou krocích: bez confirm odpověď uvádí důsledek a větu; teprve volání s touto větou provede akci.
Aplikace má nejprve získat váš souhlas. Ověřte projekt a Space; Oprávnění vysvětlují postup.
Upozornění
Všechny ostatní nástroje pracují při prvním volání, i při mazání, přepisování nebo změně webu. Potvrzovací otázka aplikace není zaručená.
Nástroje používají některé pojmy jinak než dokumentace
Popisy nástrojů jsou anglicky. Jejich německé odpovědi používají některé pojmy jinak než tato dokumentace.
| V německých odpovědích | V této dokumentaci |
|---|---|
„Stand“, „Deployment“; jako parametr deploy |
Verze. Nástroje tak označují i koncept. |
„Deployment“ při počítání tarifu; jako pole deployments |
Publikování: první publikování verze spotřebuje jedno. Opětovné publikování dříve publikované verze žádné nespotřebuje. |
| „offener Stand“ | Koncept: jeho soubory lze ještě měnit a není publikovaný. Projekt má nejvýše jeden. |
| „abgeschlossen“ | Dokončená verze: každá ověřená verze, kterou už nelze měnit, publikovaná i nepublikovaná. |
| „fertig, aber nicht veröffentlicht“ | Hotová verze: dokončená verze, která ještě nikdy nebyla publikovaná. |
| „automatic address“ v popisech nástrojů | Adresa TEISENDA: adresa, kterou TEISENDA sama přiděluje projektu. |
Každý nástroj má svou část na podstránce
Název vede k části nástroje s parametry. Titulky jsou anglicky.
| Nástroj | Název | Vlastnosti |
|---|---|---|
whoami | Show user and spaces | pouze čte |
hosting_list_projects | List projects | pouze čte |
hosting_create_project | Create project | mění údaje |
hosting_project_status | Project status | pouze čte |
hosting_rename_project | Rename project | mění údaje |
hosting_set_offline | Take project offline or online | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_delete_project | Delete project | mění údajemaže, přepisuje nebo mění viditelný obsahdva kroky |
hosting_put_files | Write files | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_delete_files | Delete files | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_list_files | List files | pouze čte |
hosting_read_file | Read file | pouze čte |
hosting_create_upload | Create upload link | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_deploy | Publish deployment | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_deploy_status | Deployment status | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_list_deploys | List deployments | pouze čte |
hosting_rollback | Roll back deployment | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_add_domain | Add domain | mění údaje |
hosting_check_domain | Check domain | mění údaje |
hosting_set_primary_domain | Set primary domain | mění údajemaže, přepisuje nebo mění viditelný obsah |
hosting_remove_domain | Remove domain | mění údajemaže, přepisuje nebo mění viditelný obsahdva kroky |
hosting_get_visibility | Get visibility | pouze čte |
hosting_set_visibility | Set visibility | mění údajemaže, přepisuje nebo mění viditelný obsahdva kroky |
hosting_list_redirects | List redirects | pouze čte |
hosting_set_redirects | Set redirects | mění údajemaže, přepisuje nebo mění viditelný obsah |
Některé limity a zprávy platí pro každé volání
Volání trvá nejvýše dvě minuty; požadavek má nejvýše 8 MB. Další limity a řešení problémů platí pro všechny nástroje.
Omezení tarifu Space uvádějí nástroje pro projekty, domény, soubory a publikování; tarify popisuje návod Tarify Free a Max.