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

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

Exemplo: um subdomínio para o blogue

curl https://api.mozout.com/v1/services/123/subdomains -X POST \
-H "Authorization: Bearer $RLX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"root_domain": "yourcompany.com", "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" }

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.