Přeskočit na obsah

IPv4 Manager

Vyhrazené adresy IPv4 pro to, co hostujete.

Otevřít IPv4 Manager
Ověřeno podle nástěnky dne 18. listopadu 2026

Všechno, co Správce IPv4 dělá s vašimi adresami, má metodu. Všechny jednají na vašem vlastním účtu a potřebují váš klíč API. Každé volání je POST na /cpi/<method> s tělem JSON, které nese klíč, a odpověď je { "code": ..., "data": ... }. Odmítnutí má záporný code a větu v data.

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

Co dělá každá obrazovka, jako volání

Tarif se vybírá v dashboardu, z okna tarifů. Nemá veřejnou metodu.

Čtení vašich adres

ipv4_list odpoví seznamem vašich adres v pořadí adres. Každá má:

ipv4_pool_status odpoví available, coming_soon, prices podle internal, external a parked a caps, které váš tarif dovoluje u internal a external. Přečtěte si ho před nákupem: když je coming_soon true, nic není v prodeji.

Nákup adresy

Zjistěte, na co může ukazovat

ipv4_attach_targets vypisuje vaše VPS, nasazení, datacentra a load balancery, každé s id, kind (vps, deployment, datacenter nebo balancer) a label. Workspace VPS nikdy není cílem pro novou adresu.

Kupte ji

ipv4_purchase bere state (internal pro věc na Xuda, external pro váš vlastní server) a target_id. Pro internal zadejte id ze seznamu, s jeho kind a label. Pro external zadejte název hostitele vašeho stroje. Výchozí karta účtu se zatíží na další faktuře. Odpověď je řádek nové adresy.

Pojmenujte ji

ipv4_set_ptr bere address a název hostitele 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')

Název reverzního DNS se uloží oříznutý a malými písmeny a musí to být název hostitele s tečkou, například mail.example.com.

Přesun, parkování a uvolnění

  • ipv4_attach nasměruje adresu, kterou držíte, na jiný cíl, s target_type internal nebo external, přepne její stav a sazbu. Účtování se poměrně rozpočítá.
  • ipv4_park zastaví, aby nikam nevedla, a ponechá ji vám za sazbu zaparkované adresy.
  • ipv4_release ji vrátí do zásoby a zastaví účtování. Odpověď má quarantine_until, den, kdy se vrátí do zásoby. Tu adresu už nezískáte zpět.

Když je volání odmítnuto

data říká proč. Důležité věty:

Účtování se kontroluje, dřív než se cokoli zabere. Pokud nelze po nákupu účtování aktualizovat, zábor se vrátí, takže odmítnutý nákup nezanechá žádnou adresu.

Nastavení připojení

ipv4_external_config odpoví mode, status a note pro adresu na vašem vlastním serveru. Dnes je stav pending: kroky k nastavení tunelu a přesměrování zatím nejsou připraveny a obrazovka to říká. Volání pro adresu, která neukazuje na váš vlastní server, je odmítnuto.

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026