Ir para o conteúdo
ZAP Customer API

API REST para desenvolvedores

Com a API REST da ZAP-Hosting, você conecta suas aplicações, bots e ferramentas aos seus serviços. Gerencie servidores de jogos, VPS, servidores dedicados e TeamSpeak ou integre pedidos e upgrades.

ClaudeCursorChatGPTGemini

O acesso à API faz parte do ZapX Pass

Primeiros passos

Comece em 3 passos

Crie uma chave de API e envie sua primeira requisição em poucos minutos.

  1. 1

    Criar chave de API

    Crie uma chave em Configurações → Acesso à API e defina as permissões necessárias.

    Ir para Acesso à API
  2. 2

    Enviar a primeira requisição

    Envie sua chave no header Authorization. O /me mostra se ela funciona e quais permissões ela tem.

  3. 3

    Usar a documentação

    Na referência interativa da API, você encontra todos os endpoints, exemplos e a especificação OpenAPI.

    Referência da API

Primeira requisição (curl)

$ curl -s https://zap-hosting.com/api/v1/me \
  -H "Authorization: Bearer zapx_…" \
  -H "Accept: application/json"
200 OK· application/json
{
  "success": true,
  "data": {
    "userId": "usr_01HXYZ",
    "token": {
      "id": "cltok_01HXYZ",
      "name": "Automation",
      "accountPermissions": ["orders.view", "orders.create"],
      "serviceGrants": [
        {
          "serviceType": "gameserver",
          "serviceId": "clgs_01HXYZ",
          "permissions": ["gameserver.view", "gameserver.start"]
        }
      ],
      "typeGrants": []
    }
  }
}

Exemplos de uso

Desenvolva sua própria integração

Seja um bot para a comunidade, um dashboard próprio ou um processo de pedidos: a API conecta sua aplicação aos seus serviços da ZAP-Hosting.

Integre a gestão de servidores à sua aplicação

Exiba status, backups e configurações na sua própria interface e execute as ações de servidor liberadas.

  • Exibir serviços e o status de cada um
  • Gerenciar backups e arquivos
  • Restringir o acesso a serviços específicos

Monitore status e logs do console em tempo real

Use dados de status atuais e logs do console como Server-Sent Events para o seu monitoramento e as suas notificações.

  • Consultar o status atual do serviço
  • Receber logs do console como fluxo de dados
  • Disparar notificações em eventos importantes

Integre pedidos e upgrades

Contrate novos serviços ou ajuste planos existentes direto na sua aplicação.

  • Disparar pedidos
  • Upgrades com prévia de preço
  • Consultar o status de mudanças de plano

Serviços suportados

Os endpoints certos para seus serviços

A Customer API cobre servidores de jogos, VPS, servidores dedicados e TeamSpeak, além de pedidos e mudanças de plano.

Servidor de jogos

Gerencie console, arquivos, backups, ações de servidor e mods.

GET /api/v1/gameservers/{id}/console/logs

Servidor VPS

Controle firewall, console, backups e a gestão do servidor.

GET /api/v1/vservers/{id}/firewall

Servidor dedicado

Gerencie ações de servidor, reinstalação, tráfego, rescue e DDoS.

GET /api/v1/dedicated-servers/{id}

TeamSpeak

Automatize configuração, clientes, bans e tokens.

GET /api/v1/teamspeak-servers/{id}

Pedido e upgrade

Contrate novos serviços e ajuste planos com prévia de preço.

POST /api/v1/orders

Acesso e segurança

Chaves de API e permissões

Mantenha o controle sobre quais serviços e ações a sua integração pode usar.

Chave de API (Bearer)

Envie sua chave no header Authorization em cada requisição para /api/v1/*. Você pode criar ou substituir chaves a qualquer momento em Configurações → Acesso à API.

Permissões por serviço

Defina quais serviços e ações a sua integração pode acessar.

Operações assíncronas

Em ações mais demoradas, você recebe um ID de operação e pode consultar o progresso pela API.

API REST com ZapX Pass PlusCrie chaves de API direto nas configurações com o Pass Plus ativo

Ver ZapX Pass

Ferramentas para desenvolvedores

Tudo para a sua integração

Use a referência da API, a especificação OpenAPI ou a nossa Postman Collection para começar.

Referência interativa da API

Teste todos os endpoints com exemplos direto no navegador.

OpenAPI

Especificação (OpenAPI 3.1) para clientes próprios e geradores de código.

Postman

Collection pronta para testar suas requisições rapidamente.

API vs. MCP

API REST ou MCP?

Escolha a API REST para aplicações próprias e o MCP para trabalhar direto com o seu cliente de IA.

Customer REST API

Para aplicações, bots, dashboards e automações próprias.

  • Fluxos personalizados e controle total das requisições
  • Pedidos e mudanças de plano a partir da sua aplicação
  • Logs em tempo real e operações assíncronas

MCP Connect

Para Cursor, Claude e outros clientes de IA com OAuth.

  • Status, backups e controle dos servidores no chat
  • Permissões definidas por cliente de IA
  • Prático para a gestão do dia a dia

FAQ

Perguntas frequentes sobre a API

Tudo o que importa sobre as suas integrações próprias com a ZapX.

Para ferramentas, apps e automações próprias.

Conecte a ZAP-Hosting ao seu dashboard, a um bot ou a uma aplicação própria. Você pode consultar serviços, gerenciar servidores, integrar backups e disparar pedidos a partir da sua aplicação.

Servidores de jogos, VPS, servidores dedicados e TeamSpeak.

A Customer API oferece funções para os seus servidores de jogos, VPS, servidores dedicados e servidores TeamSpeak existentes. As áreas disponíveis dependem da sua conta e das respectivas permissões de acesso.

Com uma chave de API pessoal.

Crie uma chave de API em Configurações → Acesso à API e envie-a no header Authorization em cada requisição. Exemplos adequados estão na documentação da API.

A interface certa para o seu caso de uso.

A API REST é feita para aplicações, bots e automações próprias. Com o MCP, você conecta a ZAP-Hosting diretamente a clientes de IA como Cursor ou Claude.

A API está incluída no ZapX Pass Plus.

Sim. Para a Customer REST API, você precisa de um ZapX Pass Plus ativo. Depois, você pode criar a sua chave de API em Configurações → Acesso à API.

Pedidos e mudanças de plano a partir da sua aplicação.

Sim. Você pode contratar novos serviços e ajustar planos existentes. Antes de uma mudança de plano, você recebe uma prévia de preço.

Ainda tem dúvidas? Nosso suporte ajuda você com prazer.

Contatar o suporte
Pronto?

Conecte suas ferramentas à ZapX

Abra a documentação da API, crie uma chave de API e comece com a sua primeira requisição.

O acesso à API faz parte do ZapX Pass