Limites de utilização do Connector
Verifique os limites de tempo, tamanho e utilização antes de chamar ferramentas.
Nesta página
Salvo indicação em contrário, os valores aplicam-se a Free e Max.
Prazos ao ligar
| O quê | Valor |
|---|---|
| Autorização completa no Connector, desde o início na aplicação até ao regresso da TEISENDA | 10 minutos, no navegador em que começou |
| Decisão na página de consentimento | 10 minutos desde que a página aparece, uma decisão por apresentação |
| Spaces de uma ligação | pelo menos um Space ou a opção de Spaces futuros |
Validade da autorização da aplicação
| O quê | Valor |
|---|---|
| Autorização da aplicação | uma hora; depois, a aplicação pode renová-la |
| Renovação da autorização | possível até 60 dias após a última renovação; cada renovação só pode ser utilizada uma vez e é substituída por uma nova ao ser utilizada |
| Tempo sem utilização a partir do qual o cartão indica a ligação como não utilizada | 60 dias; consulte Autorização e ligações não utilizadas |
Quando se aplicam as alterações da TEISENDA
| O quê | Valor |
|---|---|
| Alterações na TEISENDA: Spaces da ligação, fim de uma ligação e bloqueio de um Space | O Connector deteta-as após, no máximo, um minuto. A app aplica-as imediatamente a cada chamada de ferramenta. |
| Catálogo de ferramentas ou instruções alterados | O Connector deteta-os após, no máximo, um minuto. |
Limites de cada chamada
| O quê | Valor |
|---|---|
| Duração de uma chamada de ferramenta | dois minutos |
| Tamanho de um pedido ao Connector | 8 MB |
| Pedidos por segundo | 10 por endereço IP. Nas redes do Claude e ChatGPT, a TEISENDA conta antes 10 por autorização e 50 por endereço para pedidos sem autorização. Permite picos curtos acima destes valores; rejeita os excessos contínuos. |
| Chamadas sem autorização válida de um endereço IP | 30 em 10 minutos; depois, o endereço fica bloqueado durante uma hora. As redes do Claude e ChatGPT estão excluídas deste bloqueio. |
Limites de ficheiros e carregamentos
Se exceder os limites, pode aparecer a mensagem geral de argumento em falta ou inválido. A ajuda para resolver problemas indica as causas e soluções.
| O quê | Valor |
|---|---|
Ficheiros por chamada de hosting_put_files | 200 ficheiros e 3 MB. Mais ficheiros geram a mensagem sobre o argumento files; mais dados geram É demasiado para uma só chamada. Divida os ficheiros por várias chamadas. |
Caminhos por chamada de hosting_delete_files | 200. Mais caminhos geram a mensagem sobre o argumento paths. |
Ficheiros por resposta de hosting_list_files | 100; a resposta indica next_offset para continuar |
Ficheiro que hosting_read_file pode ler | até 200 KB; um maior gera O ficheiro é demasiado grande para ser lido aqui. Cada chamada entrega no máximo 40.000 caracteres e a resposta indica next_offset para continuar. |
| Caminhos de ficheiros | relativos, com barras; no máximo 240 caracteres, 12 níveis e 100 caracteres por nome. Sem nomes começados por ponto, exceto .well-known na pasta principal. |
| Rascunhos por projeto | no máximo um; a interface da app escreve no mesmo |
Endereço de carregamento de hosting_create_upload | Válido uma única vez e durante 15 minutos; o resultado indica a data e hora em expires_at. O arquivo tem até 200 MB, é zip, tar ou tar.gz e é enviado para o endereço por HTTP PUT. |
Respeite também os limites do alojamento
Para o tamanho dos ficheiros e versões, o número de versões e os domínios próprios, aplicam-se também os limites técnicos do alojamento. Os limites do plano podem ser inferiores.
Limites de nomes, domínios e redirecionamentos
| O quê | Valor |
|---|---|
| Nome de um projeto | 1 a 80 caracteres, sem caracteres de controlo |
| Nome de host de um domínio próprio | no máximo 253 caracteres, não é um endereço IP, sem https:// nem caminho; fora das zonas teisenda.com, teisendapages.com e teisendahosting.com |
| Redirecionamentos por projeto | 200 regras. A origem tem até 500 caracteres, o destino até 1.000 e os estados permitidos são 301, 302, 307 e 308. Se exceder um destes limites, recebe A lista não foi guardada: Uma origem ou destino demasiado longo é indicado como inválido sem referência ao comprimento. |
| Caminhos que não podem ser a origem de um redirecionamento | /.teisenda e tudo abaixo dele, /.well-known/acme-challenge e tudo abaixo dele. Também geram A lista não foi guardada: |
As ferramentas também respeitam os limites dos planos
Os valores estão em Limites do alojamento. Free permite um total de 3 publicações por Space; carregar e voltar a publicar uma versão anterior não contam. Um Space é uma área de trabalho partilhada na app.
Atenção
Uma nova versão concluída pode substituir definitivamente as versões mais antigas. A versão publicada e as cópias de segurança estão protegidas.
Com as publicações utilizadas, a escrita e o carregamento de novos ficheiros ficam bloqueados. Pode continuar a voltar a publicar versões anteriormente publicadas.
O que acontece a uma versão demasiado grande?
Uma versão que, depois de descomprimida, seja demasiado grande, tenha demasiados ficheiros ou não caiba no armazenamento é descartada na conclusão. As versões anteriores mantêm-se. max_bytes do endereço de carregamento indica o tamanho de arquivo permitido. A ajuda sobre limites dos planos explica as mensagens.
Quando envia a TEISENDA e-mails por falta de armazenamento ou projetos?
Se a utilização aumentar com uma chamada de ferramenta, aplicam-se os mesmos avisos por e-mail que na app. O momento, os destinatários e as repetições estão em E-mails de utilização.
As ferramentas continuam a funcionar num Space suspenso?
Se a TEISENDA suspender um Space após o fim da subscrição, o nó de alojamento não serve nenhum website desse Space. As ferramentas funcionam como noutro Space; o Connector não trata um Space suspenso como bloqueado.
- Aplicam-se os limites de Free; as publicações do plano anterior também contam. Se tiverem sido utilizadas, a TEISENDA rejeita
hosting_put_files,hosting_create_uploadehosting_deploypara uma versão pronta. - Nenhum resultado indica que o Space está suspenso e os visitantes veem uma página de erro. O campo
offlinerefere-se à opção do projeto individual e mantém-sefalse. hosting_create_uploadnão recebe um endereço num Space suspenso e responde com O projeto está offline.- Pode continuar a eliminar projetos e remover domínios. A mudança para Free e a nova contratação fazem-se na app; nenhuma ferramenta o faz. Saiba mais em Limites do alojamento.
Defina cópias de segurança na app
Uma cópia de segurança mantém-se quando adiciona novas versões. Defina ou remova a marca no menu de versões da app; o Connector não tem uma ferramenta para isso.
Atenção
Eliminar o projeto inteiro também elimina as cópias de segurança.
O Connector e a app mantêm registos de utilização
O Connector e a app mantêm vários registos de utilização. O conteúdo e os prazos de retenção comprovados estão em Registos do Connector e da app.