Pular para o conteúdo principal
POST
Adicionar ou editar variáveis de ambiente
string
obrigatório
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
Requer uma chave de API com o escopo envs:write. Escrever não dá acesso à leitura: sem envs:read, a resposta nunca inclui variáveis que a requisição não enviou. Use este endpoint para adicionar novas variáveis de ambiente ou atualizar variáveis específicas sem alterar as demais. Variáveis existentes que não forem incluídas no corpo da requisição permanecem intactas, o que torna esta a opção mais segura para alterações incrementais, como rotacionar uma única chave de API. Aplicações estáticas não suportam variáveis de ambiente e retornam um erro. O conjunto total é limitado a 256 variáveis por aplicação, com um limite de 1024 caracteres por chave e 4096 caracteres por valor (as aspas adicionadas em volta dele não contam). Em aplicações compartilhadas em workspace, quem chama precisa da função admin ou ser o proprietário. A Square Cloud injeta as variáveis toda vez que a sua aplicação inicia, então um valor com espaços ou caracteres especiais (como & ou ;) é guardado entre aspas simples, como o dashboard faz, e retornado assim; um valor que você já colocou entre aspas é mantido como foi enviado. Uma referência a outra variável ($HOST, ${HOST}, sozinha ou dentro de aspas duplas) continua funcionando, enquanto a substituição de comando ($(...) ou crases) é sempre guardada como texto puro. Os nomes usam letras, dígitos, sublinhados, pontos e hífens, e não começam com dígito. Para substituir todo o conjunto de variáveis em vez de mesclar, use Sobrescrever variáveis. Para remover chaves específicas, veja Remover variáveis, e para ler os valores atuais, veja Listar variáveis.

Parâmetros

string
obrigatório
O ID da aplicação.
object
obrigatório
A chave e o valor das variáveis de ambiente.

Resposta

string
Indica se a chamada foi bem-sucedida: success se foi, error se não.
object
Todas as variáveis de ambiente da aplicação depois da alteração. Uma chave de API sem o escopo envs:read recebe de volta só as variáveis que enviou nesta requisição.

Erros comuns

Relacionados