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, MT). 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.co.mz/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 |
Português
English
