Herramientas del Connector
Encuentra cada herramienta con sus efectos, límites y parámetros.
En esta página
Encuentra la herramienta adecuada y sus parámetros. Cada herramienta de hosting trabaja en un único Space.
Nota
La aplicación está conectada con tu cuenta de TEISENDA y la conexión no ha finalizado; consulta cómo en Claude y ChatGPT.
Para una herramienta de hosting, la conexión se aplica al Space indicado en la llamada. Eres miembro de él y no está bloqueado.
Tu rol en el Space permite la herramienta.
El argumento space determina el Space
Cada herramienta de hosting requiere el argumento space: el ID del Space de diez dígitos. whoami no acepta argumentos.
La aplicación debe elegir el Space a partir de whoami o de tu indicación y preguntar si hay varios Spaces posibles.
TEISENDA comprueba por sí misma en cada llamada si el Space pertenece a la conexión y si eres miembro. La herramienta solo actúa en ese único Space.
¿Qué valor acepta space ?
Un número entero de diez dígitos o un texto de exactamente diez dígitos. Para cualquier otro valor, TEISENDA responde como si faltara el Space, por ejemplo, si el número tiene menos o más dígitos. Para diez dígitos que no corresponden a un Space de la conexión, TEISENDA responde que el Space no pertenece a la conexión. Ambos mensajes aparecen en la herramienta para Spaces.
El resultado de una herramienta de hosting indica primero el Space
El resultado indica primero el ID del Space y el nombre visible. Compruébalos; si el Space es incorrecto, las instrucciones piden a la aplicación que se detenga.
Con Guardado, pero aún no transferido al nodo de hosting:, el cambio está guardado pero todavía no se ha transferido. Comprueba el estado más adelante con hosting_project_status .
¿Cuándo no es un error un resultado aunque falte algo?
Algunos resultados no están marcados como errores: la herramienta ha hecho lo que podía e indica qué falta. Ocurre si la versión indicada ya está publicada, si el DNS de un dominio todavía no es correcto, si se ha eliminado un proyecto pero el nodo de hosting aún no lo ha confirmado, y en la respuesta de una herramienta de dos pasos que pide la frase de confirmación.
¿Qué cambia una herramienta en TEISENDA y dónde lo veo?
Cada herramienta llama a los mismos servicios que la interfaz de la app, con los mismos permisos y límites. Lo que cambia una herramienta se modifica en TEISENDA como si lo hubieras hecho en la interfaz.
El registro del proyecto anota cambios con el canal Aplicación conectada cuando la operación escribe una entrada. Las herramientas de lectura no escriben ninguna. Al escribir o eliminar archivos, solo se registra que se ha abierto un nuevo borrador.
Tu rol permite la herramienta
Propietario, Administrador y Usuario pueden llamar a todas las herramientas de hosting. Las personas con el rol Solo lectura solo pueden usar cinco herramientas de lectura de hosting; la lista está en Permisos.
La lista de herramientas también muestra aquellas que tu rol no permite. El permiso se comprueba al ejecutar la llamada.
Ninguna herramienta de hosting trabaja en un Space bloqueado
whoami sigue enumerando un Space bloqueado y lo identifica como tal, pero ninguna herramienta de hosting trabaja en él. Una conexión cuyos Spaces están todos bloqueados solo ofrece a la aplicación whoami . Consulta cómo resolverlo en la herramienta para Spaces; más información sobre bloqueos en Entender los Spaces.
Las etiquetas indican si una herramienta solo lee o hace cambios
Las etiquetas aparecen junto a la herramienta y en la lista de abajo.
| Etiqueta | Significado |
|---|---|
| «solo lee» | La herramienta no cambia nada, no escribe entradas del registro visibles en la app y se puede repetir sin efectos. Se aplica a siete herramientas de hosting y a whoami. |
| «cambia datos» | La herramienta hace cambios. Se aplica a las otras 16 herramientas de hosting. |
| «elimina, sobrescribe o cambia lo visible» | La herramienta elimina, sobrescribe o cambia lo que ven los visitantes de un sitio web. La etiqueta no significa que una herramienta elimine; su sección explica qué hace. |
| «dos pasos» | La herramienta requiere una frase de confirmación. |
Tres herramientas requieren una frase de confirmación
hosting_delete_project, hosting_remove_domain y el cambio a público con hosting_set_visibility actúan en dos pasos: sin confirm , la respuesta indica las consecuencias y la frase; solo una llamada con esa frase ejecuta la acción.
La aplicación debe obtener primero tu consentimiento. Comprueba el proyecto y el Space; los permisos explican el procedimiento.
Atención
Todas las demás herramientas actúan en la primera llamada, incluso para eliminar, sobrescribir o cambiar el sitio web. No se garantiza que la aplicación pregunte.
Las herramientas usan algunos términos distintos de esta documentación
Las descripciones de las herramientas están en inglés. Sus respuestas en alemán usan algunos términos distintos de esta documentación.
| En respuestas en alemán | En esta documentación |
|---|---|
«Stand», «Deployment»; como parámetro deploy |
Versión. Las herramientas también llaman así al borrador. |
«Deployment», cuando cuenta el plan; como campo deployments |
Publicación: publicar una versión por primera vez consume una. Volver a publicar una versión que ya estuvo publicada no consume ninguna. |
| «offener Stand» | Borrador: sus archivos todavía se pueden cambiar y no está publicado. Un proyecto tiene como máximo uno. |
| «abgeschlossen» | Versión finalizada: cualquier versión comprobada que ya no se puede cambiar, esté publicada o no. |
| «fertig, aber nicht veröffentlicht» | Versión lista: una versión finalizada que nunca ha estado publicada. |
| «automatic address» en las descripciones de las herramientas | Dirección de TEISENDA: la dirección que TEISENDA asigna al proyecto. |
Cada herramienta tiene su sección en una subpágina
El nombre lleva a la sección de la herramienta con sus parámetros. Los títulos están en inglés.
| Herramienta | Título | Propiedades |
|---|---|---|
whoami | Show user and spaces | solo lee |
hosting_list_projects | List projects | solo lee |
hosting_create_project | Create project | cambia datos |
hosting_project_status | Project status | solo lee |
hosting_rename_project | Rename project | cambia datos |
hosting_set_offline | Take project offline or online | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_delete_project | Delete project | cambia datoselimina, sobrescribe o cambia lo visibledos pasos |
hosting_put_files | Write files | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_delete_files | Delete files | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_list_files | List files | solo lee |
hosting_read_file | Read file | solo lee |
hosting_create_upload | Create upload link | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_deploy | Publish deployment | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_deploy_status | Deployment status | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_list_deploys | List deployments | solo lee |
hosting_rollback | Roll back deployment | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_add_domain | Add domain | cambia datos |
hosting_check_domain | Check domain | cambia datos |
hosting_set_primary_domain | Set primary domain | cambia datoselimina, sobrescribe o cambia lo visible |
hosting_remove_domain | Remove domain | cambia datoselimina, sobrescribe o cambia lo visibledos pasos |
hosting_get_visibility | Get visibility | solo lee |
hosting_set_visibility | Set visibility | cambia datoselimina, sobrescribe o cambia lo visibledos pasos |
hosting_list_redirects | List redirects | solo lee |
hosting_set_redirects | Set redirects | cambia datoselimina, sobrescribe o cambia lo visible |
Algunos límites y mensajes se aplican a todas las llamadas
Una llamada dura como máximo dos minutos; una solicitud tiene un tamaño máximo de 8 MB. Otros límites y la ayuda para errores se aplican a todas las herramientas.
Encontrarás los límites del plan del Space en las herramientas de proyectos, dominios, archivos y publicación; los planes se explican en Planes Free y Max.