Permissões sensíveis da API e limite de gastos: pagar, comprar, reinstalar, entrar no cPanel

A resposta curta: o que pode custar dinheiro, apagar dados ou dar acesso total à conta tem permissões próprias, separadas das outras e desligadas por omissão. E cada chave tem um limite de gastos por 30 dias: com o limite a 0, a chave não gasta nada. Ligue estas permissões só na chave que precisa mesmo delas.

As permissões sensíveis

Permissão	Para quê	Estado
domains:transfer_code	Pedir o código de transferência de um domínio	Disponível
domains:owner_change	Mudar o titular de um domínio	Em breve
vps:reinstall	Reinstalar um servidor (apaga tudo)	Disponível
vps:restore	Restaurar um servidor a partir de uma cópia	Disponível
vps:password	Mudar a senha de root e recebê-la na resposta	Disponível
billing:pay	Pagar facturas com o saldo	Disponível
billing:purchase	Comprar domínios e produtos extra com o saldo	Disponível
services:cancel	Pedir o cancelamento de um serviço	Disponível
hosting:login	Criar uma ligação de entrada no cPanel, com acesso total à hospedagem	Disponível
hosting:code	Criar FTP e tarefas cron, que podem correr código na conta	Disponível

hosting:login e hosting:code dão acesso à conta do cPanel. Por isso não têm a protecção que a API dá ao domínio do e-mail da conta (o correio que recebe a reposição da senha). Uma chave com elas pode, na prática, chegar a tudo o que a hospedagem tem. Dê-as só às chaves que precisam mesmo delas.

O limite de gastos

Cada chave tem um valor máximo que pode gastar em 30 dias, na moeda da sua conta (por exemplo, USD). Escolhe-o ao criar a chave. Com o limite a 0, a chave não pode gastar.

Hoje a API só cobra do saldo da conta, e só nestes casos: compra de domínios (registo, renovação, transferência), compra de produtos extra e facturas pagas com saldo. Nunca cobra de outra forma.

Se...	A API responde	Foi cobrado?
A operação passa o limite de gastos da chave	403 spending_limit_exceeded	Não
O saldo da conta não chega	402 insufficient_credit	Não
A chave é Sandbox, ou a API está em preparação	Uma resposta simulada	Não

Ver quanto já gastou

GET /v1/limits devolve o limite de gastos da chave, o que já foi gasto e a janela de 30 dias, além dos pedidos que restam neste minuto. Qualquer chave válida a pode chamar.

curl https://api.mozout.com/v1/limits -H "Authorization: Bearer $RLX_API_KEY"

Como montar as chaves com cabeça

1	Uma chave que só lê (relatórios, painéis, alertas): nenhuma permissão sensível, limite de gastos a 0.

2	Uma chave que renova domínios: domains:write e billing:purchase, com um limite de gastos à medida das renovações previstas.

3	Uma chave de administração de VPS: vps:write para ligar e reiniciar; vps:reinstall ou vps:password só se o programa precisar mesmo, e de preferência numa chave à parte, com lista de IPs.

4	Uma chave que paga facturas: billing:pay, com lista de IPs e validade curta.

Precisa de um limite maior? O conselho da API para spending_limit_exceeded é criar uma chave com um limite maior. Faça-o na página API e revogue a antiga. Para carregar o saldo, use os métodos de pagamento habituais.

Vai dar a uma chave permissão para pagar, comprar ou reinstalar? Crie-a à parte, com lista de IPs e um limite de gastos baixo.

Criar uma chave

VEJA TAMBÉM

Permissões da API por área: ler ou alterar, e que permissão pede cada tarefa

Criar uma chave da API: nome, modo, permissões, validade, lista de IPs e limite de gastos

Facturas pela API: listar, PDF, pagar com saldo, ciclo de renovação e cancelamentos

Domínios pela API: consultar um nome, registar, renovar e transferir com o saldo

Controlar um VPS pela API: ligar, desligar, reiniciar, senha de root, reinstalar e cópias

Hospedagem pela API: subdomínios, bases de dados, tarefas cron, SSL, opções do PHP e FTP

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 396,00 MT/mês (plano de 3 anos, com cupão)

Ver planos

Categorias

Categorias