API do Sistema

Documentação da API do WebPanel

Visão Geral da API

A API do WebPanel fornece endpoints RESTful para gerenciar todos os aspectos do servidor de hospedagem. Todos os endpoints retornam JSON e seguem padrões REST.

Autenticação

Todas as requisições devem incluir um token de autenticação no header:

Authorization: Bearer YOUR_TOKEN

Base URL

https://cloud.hostclube.com/api

Endpoints Disponíveis

Domínios

  • GET /api/domains - Listar todos os domínios
  • POST /api/domains - Criar novo domínio
  • GET /api/domains/:id - Obter detalhes do domínio
  • PUT /api/domains/:id - Atualizar domínio
  • DELETE /api/domains/:id - Deletar domínio

Banco de Dados

  • GET /api/databases - Listar bancos de dados
  • POST /api/databases - Criar banco de dados
  • DELETE /api/databases/:id - Deletar banco de dados

DNS

  • GET /api/dns/:domain - Listar registros DNS
  • POST /api/dns/:domain - Adicionar registro DNS
  • PUT /api/dns/:domain/:id - Atualizar registro DNS
  • DELETE /api/dns/:domain/:id - Deletar registro DNS

SSL

  • GET /api/ssl/:domain - Verificar certificado SSL
  • POST /api/ssl/:domain - Instalar certificado SSL
  • DELETE /api/ssl/:domain - Remover certificado SSL

Exemplos de Uso

Criar Domínio

POST /api/domains
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "domain": "exemplo.com",
  "username": "exemplo",
  "php_version": "8.3",
  "install_ssl": true,
  "create_database": true
}

Resposta de Sucesso

{
  "success": true,
  "data": {
    "id": 1,
    "domain": "exemplo.com",
    "username": "exemplo",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Códigos de Status HTTP

  • 200 - Sucesso
  • 201 - Criado com sucesso
  • 400 - Requisição inválida
  • 401 - Não autenticado
  • 403 - Sem permissão
  • 404 - Não encontrado
  • 500 - Erro interno do servidor

Rate Limiting

A API possui um limite de 100 requisições por minuto por usuário. Exceder este limite resultará em status 429.

Webhooks

Você pode configurar webhooks para receber notificações sobre eventos importantes:

  • Criação de domínio
  • Instalação de SSL
  • Backup concluído
  • Alertas de sistema
Documentação