Saltar para o conteúdo

IPv4 Manager

Endereços IPv4 dedicados para o que aloja.

Abrir IPv4 Manager
Verificado com o painel em 18 de novembro de 2026

Tudo o que o IPv4 Manager faz com os seus endereços tem um método. Todos atuam na sua própria conta e precisam da sua chave de API. Cada chamada é um POST para /cpi/<method> com um corpo JSON que leva a chave, e a resposta é { "code": ..., "data": ... }. Uma recusa tem um code negativo e uma frase em data.

bash
curl -s https://xuda.ai/cpi/ipv4_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY"}'

O que cada ecrã faz, como chamada

O plano é escolhido no dashboard, a partir da janela de planos. Não tem método público.

Ler os seus endereços

ipv4_list responde com uma lista dos seus endereços por ordem de endereço. Cada um tem:

ipv4_pool_status responde com available, coming_soon, os prices por internal, external e parked, e os caps que o seu plano permite em internal e external. Leia-o antes de uma compra: quando coming_soon é verdadeiro, nada está à venda.

Comprar um endereço

Descubra para o que pode apontar

ipv4_attach_targets lista os seus VPS, implementações, datacenters e balanceadores de carga, cada um com um id, um kind (vps, deployment, datacenter ou balancer) e um label. Um VPS do espaço de trabalho nunca é um destino para um novo endereço.

Compre-o

ipv4_purchase recebe state (internal para uma coisa na Xuda, external para o seu próprio servidor) e target_id. Para internal, dê o id da lista, com o seu kind e label. Para external, dê o nome do host da sua máquina. O cartão predefinido da conta é cobrado na sua próxima fatura. A resposta é a linha do novo endereço.

Dê-lhe um nome

ipv4_set_ptr recebe o address e um nome de host ptr.

curl -s https://xuda.ai/cpi/ipv4_purchase \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","state":"internal","target_id":"YOUR_TARGET_ID","kind":"vps","label":"My server"}'

curl -s https://xuda.ai/cpi/ipv4_set_ptr \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","address":"YOUR_ADDRESS","ptr":"mail.example.com"}'
const call = async (method, body) => {
  const res = await fetch(`https://xuda.ai/cpi/${method}`, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ api_key: 'YOUR_API_KEY', ...body }),
  });
  return res.json();
};

const bought = await call('ipv4_purchase', { state: 'internal', target_id: 'YOUR_TARGET_ID', kind: 'vps', label: 'My server' });
if (bought.code > 0) await call('ipv4_set_ptr', { address: bought.data.address, ptr: 'mail.example.com' });
import requests

def call(method, **body):
    res = requests.post(f'https://xuda.ai/cpi/{method}', json={'api_key': 'YOUR_API_KEY', **body})
    return res.json()

bought = call('ipv4_purchase', state='internal', target_id='YOUR_TARGET_ID', kind='vps', label='My server')
if bought['code'] > 0:
    call('ipv4_set_ptr', address=bought['data']['address'], ptr='mail.example.com')

O nome de DNS inverso é guardado aparado e em minúsculas, e tem de ser um nome de host com um ponto, como mail.example.com.

Mover, reservar e libertar

  • ipv4_attach aponta um endereço que tem para outro destino, com target_type internal ou external, mudando o seu estado e a sua taxa. A fatura é proporcional.
  • ipv4_park impede-o de chegar a qualquer coisa e mantém-no para si à taxa de reserva.
  • ipv4_release devolve-o ao conjunto e pára a faturação. A resposta tem quarantine_until, o dia em que volta ao conjunto. Não pode voltar a obter esse endereço.

Quando uma chamada é recusada

data diz porquê. As frases que importam:

A faturação é verificada antes de ser reclamado seja o que for. Se a faturação não puder ser atualizada depois de uma compra, a reclamação é desfeita, por isso uma compra recusada não deixa nenhum endereço para trás.

Configuração da ligação

ipv4_external_config responde com mode, status e note para um endereço no seu próprio servidor. Hoje o estado lê pending: os passos para configurar o túnel e o reencaminhamento ainda não estão prontos, e o ecrã di-lo. Uma chamada para um endereço que não aponta para o seu próprio servidor é recusada.

Que tal está este guia?

Última atualização em 16 de novembro de 2026