Português
English
A resposta curta: a API lê os serviços da conta e gere as hospedagens activas: uso do plano, subdomínios, domínios adicionais, redireccionamentos, bases de dados, tarefas cron, SSL, opções do PHP, cópias e FTP. Tudo corre na conta desse serviço. Lê com hosting:read e altera com hosting:write.
Encontrar o serviço
GET /v1/services devolve todos os serviços da conta, primeiro os mais recentes, em páginas (filtro ?status=active). GET /v1/services/{id} mostra o produto, o endereço, o estado, o ciclo, o valor e a próxima data de pagamento, mas nunca senhas. Enquanto um serviço está por pagar, domain e username podem vir a null. O id é o que usa em todas as operações abaixo.
O que pode gerir
| Área | Operações | Notas |
| Uso | GET /v1/services/{id}/usage | Disco, tráfego e recursos do plano. |
| Subdomínios | GET, POST, DELETE .../subdomains | Apagar pede o nome em confirm. |
| Domínios adicionais | GET, POST, DELETE .../addon-domains | Apagar pede o nome em confirm. |
| Redireccionamentos | GET, POST, DELETE .../redirects | Apaga-se só com o id. |
| Bases de dados e utilizadores | .../databases, .../database-users | O prefixo da conta junta-se sozinho ao criar. |
| Tarefas cron | GET, POST, DELETE .../cron | Criar precisa de hosting:code. |
| SSL | GET .../ssl, POST .../ssl/autossl | Pedir os gratuitos, uma vez a cada 15 minutos. |
| PHP | GET .../php, GET e PUT .../php/options | Lê a versão; altera opções como memory_limit. |
| Cópias | GET e POST .../backups | Uma cópia completa pedida, uma vez por dia. |
| FTP | .../ftp-accounts | Criar e mudar senhas precisa de hosting:code. |
Exemplo: um subdomínio para o blogue
curl https://api.interweb.co.mz/v1/services/123/subdomains -X POST \
-H "Authorization: Bearer $RLX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"root_domain": "asuaempresa.co.mz", "name": "blog", "directory": "public_html/blog"}'
As pastas são sempre relativas à pasta da conta, como public_html/blog; não se aceitam .. nem pastas de sistema. Um domínio adicional, ou a raiz de um subdomínio, tem de estar activo na sua conta (registado connosco, ou ser o de uma hospedagem activa); caso contrário, a resposta é 409 com domain_not_owned. Um domínio registado noutro lado junta-se no cPanel.
Tarefas cron sem comandos livres
Para criar uma tarefa indica php_script (um ficheiro PHP da conta) ou url (um endereço público que é chamado), e o horário em schedule. O intervalo mínimo é de 5 minutos e cada conta tem até 20 tarefas. O endereço tem de usar um nome de domínio que resolva para endereços públicos, nunca um IP nem um nome interno. Para outros comandos, use o cPanel.
{ "schedule": "*/15 * * * *", "php_script": "public_html/cron.php" }
| A ligação de entrada no cPanel (POST /v1/services/{id}/cpanel-login, com hosting:login) só serve uma vez e dá acesso total ao painel: use-a logo e não a guarde em registos. Pela mesma razão, o comando de uma tarefa cron só vem preenchido com hosting:code; sem ela, vem command_hidden a true. |
Quando responde 409 ou 502
Só numa hospedagem activa, num servidor suportado. Caso contrário, 409 com not_hosting, service_not_active, server_not_supported ou service_not_ready; um serviço de outra conta dá 404. Se o servidor não responder como esperado, a resposta é 502. As alterações têm um limite de 20 por minuto, por hospedagem, e a entrada no painel de 5 por minuto.
| O que ainda se faz no cPanel ou no Meu Interweb: mudar a versão do PHP, os ficheiros, o Git, o Node.js e restaurar cópias. As senhas das bases de dados têm de 12 a 128 caracteres, com pelo menos 3 tipos entre minúsculas, maiúsculas, números e símbolos, e nunca voltam nas respostas. Para dar acesso a outras ferramentas sem a API, há também os tokens de API do cPanel. |
|
Quer automatizar a sua hospedagem? Veja a página da API e comece com uma chave Sandbox só com hosting:read. Ver a página da API |
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão) Ver planos |
