API de pré-visualização para convidados

Crie um link de pré-visualização temporário a partir do seu código com uma única requisição HTTP. Este endpoint não exige chave de API.

Endpoint

POST /api/guest-preview-links

Requisição

Envie JSON com o endereço IP público do novo servidor e o nome do domínio a pré-visualizar.

Exemplo

curl -X POST https://hostsclick.com/api/guest-preview-links \
  -H "Content-Type: application/json" \
  -d '{"ip":"YOUR.SERVER.IP","hostname":"example.com"}'

Resposta

Uma requisição bem-sucedida retorna HTTP 201 com a URL de pré-visualização, o subdomínio e a data de expiração. Um link de convidado expira 10 minutos após ser criado.

Limites

• 10 requisições por minuto por endereço IP. Requisições acima desse limite recebem HTTP 429.
• O IP deve ser público. Faixas privadas e reservadas são recusadas.
• Domínios do Facebook, X (Twitter) e Reddit não são permitidos.

Outros endpoints

As rotas /api/preview-links e /api/server-diff exigem uma chave de API, enviada no cabeçalho X-API-Key ou como token Bearer.