Strumenti del Connector
Trova ogni strumento con effetti, limiti e parametri.
In questa pagina
Trova lo strumento adatto e i suoi parametri. Ogni strumento di hosting opera in esattamente uno Space.
Nota
L’applicazione è collegata al tuo account TEISENDA e il collegamento non è terminato; le istruzioni sono in Claude e ChatGPT.
Per uno strumento di hosting il collegamento vale per lo Space indicato nella chiamata. Sei membro e lo Space non è bloccato.
Il tuo ruolo nello Space consente lo strumento.
L’argomento space determina lo Space
Ogni strumento di hosting richiede l’argomento space: l’ID dello Space di dieci cifre. whoami non accetta argomenti.
L’applicazione deve scegliere lo Space da whoami o dalle tue indicazioni e chiedere se ci sono più Spaces possibili.
TEISENDA verifica a ogni chiamata che lo Space appartenga al collegamento e che tu sia membro. Lo strumento opera solo in quello Space.
Quale valore accetta space?
Un numero intero di dieci cifre oppure un testo composto da esattamente dieci cifre. TEISENDA tratta qualsiasi altro valore come uno Space mancante, per esempio un numero con meno o più cifre. Per dieci cifre che non indicano uno Space del collegamento, TEISENDA risponde che lo Space non appartiene al collegamento. Entrambi i messaggi sono nello strumento per gli Spaces.
Il risultato di uno strumento di hosting indica prima lo Space
Il risultato indica prima ID dello Space e nome visualizzato. Verifica questi dati; se lo Space è sbagliato, le istruzioni richiedono che l’applicazione si fermi.
Con Salvato, ma non ancora trasferito al nodo di hosting: la modifica è salvata ma non ancora trasferita. Verifica lo stato più tardi con hosting_project_status.
Quando un risultato non è un errore anche se qualcosa è ancora in sospeso?
Alcuni risultati non sono contrassegnati come errori: lo strumento ha fatto ciò che poteva e indica ciò che manca. Succede quando la versione indicata è già pubblicata, il DNS di un dominio non è ancora corretto, un progetto è eliminato ma il nodo di hosting non ha ancora confermato oppure uno strumento in due passaggi richiede la frase di conferma.
Cosa modifica uno strumento in TEISENDA e dove lo vedo?
Ogni strumento chiama gli stessi servizi dell’interfaccia dell’app, con gli stessi permessi e limiti. Una modifica fatta da uno strumento è applicata in TEISENDA come se l’avessi fatta nell’interfaccia.
Il registro del progetto annota le modifiche con il canale Applicazione collegata per le operazioni che scrivono una voce. Gli strumenti di lettura non scrivono voci. Quando vengono scritti o eliminati file, annota solo l’apertura di una nuova bozza.
Il tuo ruolo consente lo strumento
Le persone con il ruolo Proprietario, Amministratore o Utente possono chiamare tutti gli strumenti di hosting. Le persone con il ruolo Sola lettura possono usare solo cinque strumenti di hosting di lettura; l’elenco è in Permessi.
L’elenco mostra anche strumenti non consentiti dal tuo ruolo. Il diritto viene verificato durante la chiamata.
Nessuno strumento di hosting opera in uno Space bloccato
whoami continua a elencare uno Space bloccato e lo contrassegna, ma nessuno strumento di hosting vi opera. Un collegamento con tutti gli Spaces bloccati offre all’applicazione solo whoami. Il rimedio è nello strumento per gli Spaces; per i blocchi leggi Capire gli Spaces.
Le indicazioni mostrano se uno strumento legge soltanto o modifica qualcosa
Le indicazioni appaiono accanto allo strumento e nell’elenco sotto.
| Indicazione | Significato |
|---|---|
| «legge soltanto» | Lo strumento non modifica nulla, non scrive voci di registro visibili nell’app e può essere ripetuto senza effetti. Vale per sette strumenti di hosting e per whoami. |
| «modifica dati» | Lo strumento modifica qualcosa. Vale per gli altri 16 strumenti di hosting. |
| «elimina, sovrascrive o modifica ciò che è visibile» | Lo strumento elimina, sovrascrive o modifica ciò che vedono i visitatori di un sito web. L’indicazione non significa che uno strumento elimini; la sua sezione descrive cosa fa. |
| «due passaggi» | Lo strumento richiede una frase di conferma. |
Tre strumenti richiedono una frase di conferma
hosting_delete_project, hosting_remove_domain e il passaggio a pubblico con hosting_set_visibility operano in due passaggi: senza confirm, la risposta indica conseguenza e frase; solo una chiamata con quella frase esegue l’azione.
L’applicazione deve prima ottenere il tuo consenso. Verifica progetto e Space; i permessi spiegano la procedura.
Attenzione
Tutti gli altri strumenti operano alla prima chiamata, anche quando eliminano, sovrascrivono o modificano il sito web. Non è garantita una richiesta di conferma dell’applicazione.
Gli strumenti usano alcuni termini diversi da questa documentazione
Le descrizioni degli strumenti sono in inglese. Le risposte in tedesco usano alcuni termini diversi dalla documentazione.
| Nelle risposte in tedesco | In questa documentazione |
|---|---|
«Stand», «Deployment»; come parametro deploy | Versione. Gli strumenti usano questi termini anche per la bozza. |
«Deployment», quando il piano conta; come campo deployments | Pubblicazione: pubblicare una versione per la prima volta ne utilizza una. Ripubblicare una versione già pubblicata in passato non ne utilizza. |
| «offener Stand» | Bozza: i suoi file possono ancora essere modificati e non è pubblicata. Un progetto ne ha al massimo una. |
| «abgeschlossen» | Versione finalizzata: ogni versione verificata che non può più essere modificata, pubblicata o meno. |
| «fertig, aber nicht veröffentlicht» | Versione pronta: una versione finalizzata mai pubblicata. |
| «automatic address» nelle descrizioni degli strumenti | Indirizzo TEISENDA: l’indirizzo assegnato direttamente da TEISENDA al progetto. |
Ogni strumento ha una sezione in una sottopagina
Il nome porta alla sezione dello strumento con i suoi parametri. I titoli sono in inglese.
| Strumento | Titolo | Proprietà |
|---|---|---|
whoami | Show user and spaces | legge soltanto |
hosting_list_projects | List projects | legge soltanto |
hosting_create_project | Create project | modifica dati |
hosting_project_status | Project status | legge soltanto |
hosting_rename_project | Rename project | modifica dati |
hosting_set_offline | Take project offline or online | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_delete_project | Delete project | modifica datielimina, sovrascrive o modifica ciò che è visibiledue passaggi |
hosting_put_files | Write files | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_delete_files | Delete files | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_list_files | List files | legge soltanto |
hosting_read_file | Read file | legge soltanto |
hosting_create_upload | Create upload link | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_deploy | Publish deployment | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_deploy_status | Deployment status | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_list_deploys | List deployments | legge soltanto |
hosting_rollback | Roll back deployment | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_add_domain | Add domain | modifica dati |
hosting_check_domain | Check domain | modifica dati |
hosting_set_primary_domain | Set primary domain | modifica datielimina, sovrascrive o modifica ciò che è visibile |
hosting_remove_domain | Remove domain | modifica datielimina, sovrascrive o modifica ciò che è visibiledue passaggi |
hosting_get_visibility | Get visibility | legge soltanto |
hosting_set_visibility | Set visibility | modifica datielimina, sovrascrive o modifica ciò che è visibiledue passaggi |
hosting_list_redirects | List redirects | legge soltanto |
hosting_set_redirects | Set redirects | modifica datielimina, sovrascrive o modifica ciò che è visibile |
Alcuni limiti e messaggi si applicano a ogni chiamata
Una chiamata dura al massimo due minuti; una richiesta ha al massimo 8 MB. Altri limiti e le istruzioni per risolvere problemi si applicano a tutti gli strumenti.
I limiti del piano dello Space sono negli strumenti per progetti, domini, file e pubblicazione; i piani sono descritti in Piani Free e Max.