Naar de inhoud springen

IPv4 Manager

Dedicated IPv4-adressen voor wat je host.

IPv4 Manager openen
Gecontroleerd aan de hand van het dashboard op 18 november 2026

Alles wat de IPv4 Manager met je adressen doet, heeft een methode. Ze handelen allemaal op je eigen account en vragen je API-sleutel. Elke aanroep is een POST naar /cpi/<method> met een JSON-body die de sleutel meeneemt, en het antwoord is { "code": ..., "data": ... }. Een weigering heeft een negatieve code en een zin in data.

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

Wat elk scherm doet, als aanroep

Het abonnement kies je in het dashboard, in het abonnementenvenster. Daarvoor is er geen openbare methode.

Je adressen lezen

ipv4_list geeft een lijst van je adressen terug in adresvolgorde. Elk heeft:

ipv4_pool_status geeft available, coming_soon, de prices per internal, external en parked, en de caps die je abonnement toestaat op internal en external. Lees het voor een aankoop: als coming_soon waar is, is er niets in de verkoop.

Een adres kopen

Zoek waar het op kan wijzen

ipv4_attach_targets toont je VPS'en, deployments, datacenters en load balancers, elk met een id, een kind (vps, deployment, datacenter of balancer) en een label. Een Workspace VPS is nooit een doel voor een nieuw adres.

Koop het

ipv4_purchase neemt state (internal voor iets op Xuda, external voor je eigen server) en target_id. Geef voor internal de id uit de lijst, met zijn kind en label. Geef voor external de hostnaam van je machine. De standaardkaart van het account wordt afgeschreven op de volgende factuur. Het antwoord is de rij van het nieuwe adres.

Geef het een naam

ipv4_set_ptr neemt het address en een hostnaam 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')

De reverse-DNS-naam wordt opgeslagen zonder omringende spaties en in kleine letters, en moet een hostnaam met een punt zijn, zoals mail.example.com.

Verplaatsen, parkeren en vrijgeven

  • ipv4_attach richt een adres dat je hebt op een ander doel, met target_type internal of external, wat zijn toestand en zijn tarief omschakelt. De rekening wordt naar rato berekend.
  • ipv4_park stopt dat het iets bereikt en bewaart het voor je tegen het tarief voor geparkeerd.
  • ipv4_release geeft het terug aan de pool en stopt de facturering. Het antwoord heeft quarantine_until, de dag waarop het terugkeert naar de pool. Dat adres krijg je niet terug.

Als een aanroep wordt geweigerd

data zegt waarom. De zinnen die ertoe doen:

De facturering wordt gecontroleerd voordat er iets wordt geclaimd. Als de facturering na een aankoop niet kan worden bijgewerkt, wordt de claim ongedaan gemaakt, dus een geweigerde aankoop laat geen adres achter.

Verbinding instellen

ipv4_external_config geeft mode, status en note voor een adres op je eigen server. Vandaag luidt de status pending: de stappen om de tunnel en het doorsturen in te stellen zijn nog niet klaar, en het scherm zegt dat. Een aanroep voor een adres dat niet op je eigen server wijst, wordt geweigerd.

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026