Preskočiť na obsah

IPv4 Manager

Vyhradené adresy IPv4 pre to, čo hostujete.

Otvoriť IPv4 Manager
Overené voči nástenke dňa 18. novembra 2026

Všetko, čo Správca IPv4 robí s vašimi adresami, má metódu. Všetky pôsobia na váš vlastný účet a potrebujú váš kľúč API. Každé volanie je POST na /cpi/<method> s telom JSON, ktoré nesie kľúč, a odpoveď je { "code": ..., "data": ... }. Odmietnutie má záporný code a vetu v data.

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

Čo robí každá obrazovka, ako volanie

Plán sa vyberá v nástenke, v okne plánov. Nemá verejnú metódu.

Čítanie vašich adries

ipv4_list odpovie zoznamom vašich adries v poradí podľa adresy. Každá má:

ipv4_pool_status odpovie available, coming_soon, prices podľa internal, external a parked a caps, ktoré váš plán dovoľuje na internal a external. Prečítajte si ho pred nákupom: keď je coming_soon true, nič nie je v predaji.

Kúpa adresy

Nájdite, na čo môže ukazovať

ipv4_attach_targets uvádza vaše VPS, nasadenia, dátové centrá a záťažové balancéry, každé s id, kind (vps, deployment, datacenter alebo balancer) a label. Workspace VPS nie je nikdy cieľom pre novú adresu.

Kúpte ju

ipv4_purchase berie state (internal pre vec na Xuda, external pre váš vlastný server) a target_id. Pre internal zadajte id zo zoznamu s jeho kind a label. Pre external zadajte názov hostiteľa vášho stroja. Predvolená karta účtu sa účtuje na jeho ďalšej faktúre. Odpoveď je riadok novej adresy.

Pomenujte ju

ipv4_set_ptr berie address a názov hostiteľa 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ázov reverzného DNS sa uloží orezaný a malými písmenami a musí byť názov hostiteľa s bodkou, napríklad mail.example.com.

Presun, odloženie a uvoľnenie

  • ipv4_attach nasmeruje adresu, ktorú držíte, na iný cieľ, s target_type internal alebo external, a prepne jej stav a sadzbu. Účet sa prepočíta pomerne.
  • ipv4_park zastaví, aby nič nedosahovala, a uchová ju pre vás za sadzbu pre odložené.
  • ipv4_release ju vráti do zásoby a zastaví účtovanie. Odpoveď má quarantine_until, deň, keď sa vráti do zásoby. Túto adresu už nedostanete späť.

Keď sa volanie odmietne

data povie prečo. Vety, na ktorých záleží:

Fakturácia sa kontroluje skôr, než sa čokoľvek nárokuje. Ak sa fakturácia po nákupe nedá aktualizovať, nárok sa zruší, takže odmietnutý nákup nezanechá žiadnu adresu.

Nastavenie pripojenia

ipv4_external_config odpovie mode, status a note pre adresu na vašom vlastnom serveri. Dnes je stav pending: kroky na nastavenie tunela a presmerovania ešte nie sú pripravené a obrazovka to povie. Volanie pre adresu, ktorá neukazuje na váš vlastný server, sa odmietne.

Aký je tento návod?

Naposledy aktualizované dňa 20. novembra 2026