Bem-vindo à PingHost

Hospedamos bots do Discord e APIs HTTP (Node.js e Python) 24/7. Envie o código pelo /up e pronto — URL fixa e HTTPS automáticos incluídos.

# Hospedagem de APIs

A PingHost hospeda qualquer tipo de API HTTP (Node.js e Python):

• APIs REST — Express, Fastify, Koa, NestJS (Node)
• APIs Python — FastAPI, Flask, Django
• Webhooks & integrações — endpoints para receber chamadas externas
• Bots com API embutida — o mesmo projeto roda o bot e expõe endpoints

#Visão geral

Sua API fica pública no domínio da PingHost. O caminho da requisição:

Quem consome só precisa da URL pública:

• Clientes chamam https://api.pinghost.2bd.net/<sua-app>/... (ex.: /health)
• Você entrega essa URL para sites, webhooks e bots — endereço fixo e profissional
• A PingHost cuida de HTTPS, disponibilidade 24/7 e repasse da requisição

#Como funciona

Ao enviar seu projeto pelo /up, a PingHost detecta automaticamente se o código é uma API e configura tudo:

Cadeia da sua URL

#Começando

#Limites por plano

Cada plano inclui uma cota de bots e uma cota de APIs. As APIs começam a partir do plano LITE:

#Exemplos de código

Qualquer aplicação que abra um servidor HTTP vira API. Os exemplos abaixo funcionam direto — compacte e suba pelo /up.

Node.js — Express

Estrutura mínima do .zip:

minha-api/
├── server.js
└── package.json

server.js

const express = require('express');
const app = express();
app.use(express.json());

app.get('/', (req, res) => res.json({ ok: true, name: 'Minha API' }));
app.get('/health', (req, res) => res.json({ status: 'online' }));
app.post('/echo', (req, res) => res.json(req.body));

const port = process.env.PORT || 3000;
app.listen(port, () => console.log(`API na porta ${port}`));

package.json (as dependências são instaladas automaticamente)

{
  "name": "minha-api",
  "main": "server.js",
  "dependencies": { "express": "^4.19.2" }
}

Python — FastAPI

main.py

from fastapi import FastAPI

app = FastAPI(title='Minha API')

@app.get('/')
def root():
    return {'ok': True}

@app.get('/health')
def health():
    return {'status': 'online'}

requirements.txt

fastapi
uvicorn

Python — Flask

app.py

import os
from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/')
def root():
    return jsonify(ok=True)

@app.route('/health')
def health():
    return jsonify(status='online')

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=int(os.environ.get('PORT', 3000)))

#Variáveis de ambiente

Inclua um .env no zip com suas variáveis (chaves de serviços, URLs de banco…). Elas são preservadas e injetadas na aplicação.

#Bot + API juntos (híbrido)

Bot do Discord e API no mesmo projeto? Funciona:

• O sistema detecta o bot e pede o token.
• Detecta o servidor HTTP e abre a URL pública.
• O projeto recebe as duas coisas: token no .env e URL fixa.

Detecção inteligente: bots que usam .listen() só para webhook (sem framework web) não contam como API — evita falsos positivos.

#URL fixa pública

Toda API hospedada recebe uma URL no formato:

Exemplo real:

• HTTPS automático — certificado SSL incluído, sem configuração.
• Nunca muda — reinícios, atualizações e quedas não alteram a URL.
• Pronta para produção — aponte webhooks, integrações e clientes para a URL com confiança.

#Como usar sua API

Consumir é simples: sua URL fixa é a base e cada rota do código vira um caminho. Todos os métodos HTTP funcionam; corpo e headers são repassados para a sua aplicação.

Montando a URL de um endpoint

Se sua URL fixa é https://api.pinghost.2bd.net/123456789012345678_minha_api/ e o código tem a rota /health:

Regras simples:

• Rota raiz → https://api.pinghost.2bd.net/<app>/ (a barra final opcional)
• Qualquer rota do seu código → https://api.pinghost.2bd.net/<app>/sua-rota
• Parâmetros de rota → https://api.pinghost.2bd.net/<app>/usuarios/42
• Query string → https://api.pinghost.2bd.net/<app>/busca?q=pinghost&limite=10

Testando com curl

O jeito mais rápido de verificar se a API responde:

# GET simples (health check)
curl https://api.pinghost.2bd.net/123456789012345678_minha_api/health

# POST com JSON (envie dados para sua API)
curl -X POST https://api.pinghost.2bd.net/123456789012345678_minha_api/usuarios \
  -H 'Content-Type: application/json' \
  -d '{"nome": "PingHost", "plano": "PRO"}'

# Com header de autenticação (se sua API exigir)
curl https://api.pinghost.2bd.net/123456789012345678_minha_api/dados \
  -H 'Authorization: Bearer sua-chave-aqui'

Consumindo de um bot Discord (Node.js)

Use fetch (nativo do Node 18+) ou axios:

// fetch nativo (Node 18+)
const resp = await fetch('https://api.pinghost.2bd.net/123456789012345678_minha_api/health');
const data = await resp.json();
console.log(data); // { status: 'online' }

// POST com JSON
const criado = await fetch('https://api.pinghost.2bd.net/123456789012345678_minha_api/usuarios', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ nome: 'PingHost' }),
});
const resultado = await criado.json();
console.log(resultado);

// Com autenticação
const privado = await fetch('https://api.pinghost.2bd.net/123456789012345678_minha_api/dados', {
  headers: { Authorization: 'Bearer sua-chave-aqui' },
});
console.log(await privado.json());

Consumindo de Python

import requests

# GET simples
resp = requests.get('https://api.pinghost.2bd.net/123456789012345678_minha_api/health')
print(resp.json())  # {'status': 'online'}

# POST com JSON
resp = requests.post(
    'https://api.pinghost.2bd.net/123456789012345678_minha_api/usuarios',
    json={'nome': 'PingHost'},
)
print(resp.json())

# Com autenticação
resp = requests.get(
    'https://api.pinghost.2bd.net/123456789012345678_minha_api/dados',
    headers={'Authorization': 'Bearer sua-chave-aqui'},
)
print(resp.json())

Limites e códigos de resposta

#Solução de problemas

A URL retorna "API não encontrada ou ainda sem URL pública"

• A URL leva ~30 segundos a 2 minutos para aparecer após a app subir — aguarde e tente de novo.
• Confirme que a app está online (veja o status em Minhas Aplicações).
• Confirme que seu plano inclui APIs (LITE ou superior) e que você não atingiu o limite.

Minha API não foi reconhecida como API

O sistema só detecta API quando o arquivo principal abre um servidor HTTP:

• O entrypoint se chama server.js, app.js, index.js, main.py, app.py…
• O código usa .listen(, createServer(, app.run(, uvicorn.run, ou frameworks como Express/Fastify/Flask/FastAPI.
• O entrypoint não é claramente um bot do Discord (sem discord.js/discord.py no arquivo principal).

A app cai ou reinicia sozinha (502 / erro de código)

• Abra os logs em Minhas Aplicações — a mensagem de erro aponta o problema e a linha.
• Confira se as dependências estão no package.json / requirements.txt.
• Não inclua node_modules no zip — ela é instalada automaticamente.
• Use process.env.PORT / os.environ['PORT'] para escutar a porta.

#Perguntas frequentes

Respostas rápidas para as dúvidas mais comuns.

Respostas rápidas para as dúvidas mais comuns. Clique em uma pergunta para ver a resposta.