# Hydro (AcquaCloud)

> Hospedagem de aplicações (sites, APIs, bots e workers) e bancos de dados gerenciados (PostgreSQL, MySQL, Redis, MongoDB). API REST em https://api.acquacloud.com.br, autenticada com um token de API por workspace (Authorization: Bearer hydro_pat_…).

- Todas as páginas em um arquivo: https://0.0.0.0:3002/llms-full.txt
- Especificação OpenAPI da API pública: https://0.0.0.0:3002/openapi.json

## Produto

- [Introdução](https://0.0.0.0:3002/docs/index.mdx): O que é o Hydro, os conceitos principais e por onde começar.
- [Primeiros passos](https://0.0.0.0:3002/docs/primeiros-passos.mdx): Crie a conta, o workspace e coloque a primeira aplicação no ar.
- [Usar com IA](https://0.0.0.0:3002/docs/ia.mdx): Leve a documentação do Hydro para o ChatGPT, o Claude, o Cursor ou o seu agente, em Markdown.

## Recursos

- [Workspaces e permissões](https://0.0.0.0:3002/docs/workspaces.mdx): Papéis, convites, transferência de propriedade e limites.
- [Planos e quotas](https://0.0.0.0:3002/docs/planos-e-quotas.mdx): Como funcionam o período de teste, o pool de recursos do workspace e os limites.
- [Aplicações](https://0.0.0.0:3002/docs/aplicacoes.mdx): Tipos, origens do código, endereço em acq.lat, deploy, variáveis de ambiente, domínios e backups.
- [Deploy pelo GitHub](https://0.0.0.0:3002/docs/deploy-github.mdx): Conectar uma conta ou organização do GitHub, criar apps a partir de um repositório e usar monorepos.
- [Logs, métricas, terminal e arquivos](https://0.0.0.0:3002/docs/aplicacoes-runtime.mdx): Acompanhar a aplicação no ar, ver o consumo, abrir um shell no container e ver ou editar o código do projeto.
- [Bancos de dados](https://0.0.0.0:3002/docs/bancos-de-dados.mdx): PostgreSQL, MySQL, Redis e MongoDB gerenciados, na rede privada do workspace e com acesso externo opcional.
- [Cobrança](https://0.0.0.0:3002/docs/cobranca.mdx): Assinar um plano, pagar com Pix, boleto ou cartão, mudar de plano e o que acontece quando uma fatura atrasa.

## Guias

- [Hospedar um bot do Discord](https://0.0.0.0:3002/docs/guias/bot-discord.mdx): Coloque um bot feito com discord.js ou discord.py online 24/7 no Hydro, com o token como segredo.
- [Hospedar um bot do WhatsApp](https://0.0.0.0:3002/docs/guias/bot-whatsapp.mdx): Rode um bot com Baileys 24/7 no Hydro sem perder a sessão a cada deploy.
- [Hospedar um bot do Telegram](https://0.0.0.0:3002/docs/guias/bot-telegram.mdx): Long polling como worker ou webhook com HTTPS automático, com Telegraf, grammY, python-telegram-bot ou aiogram.
- [Variáveis de ambiente e tokens](https://0.0.0.0:3002/docs/guias/variaveis-e-tokens.mdx): Como guardar o token do bot, senhas e chaves de API com segurança no Hydro.

## API

- [Convenções da API](https://0.0.0.0:3002/docs/api.mdx): Endereço, versionamento, formato, erros, paginação, idempotência e limites.
- [Autenticação](https://0.0.0.0:3002/docs/api/autenticacao.mdx): Tokens de API por workspace, escopos e boas práticas.
- [Códigos de erro](https://0.0.0.0:3002/docs/api/erros.mdx): Os códigos estáveis do campo code nos erros da API do Hydro, com a mensagem padrão de cada um e os status HTTP mais comuns.