Zum Inhalt springen

IPv4 Manager

Dedizierte IPv4-Adressen für das, was du hostest.

IPv4 Manager öffnen
Am 18. November 2026 mit dem Dashboard abgeglichen

Alles, was der IPv4 Manager mit deinen Adressen tut, hat eine Methode. Alle handeln für dein eigenes Konto und brauchen deinen API-Schlüssel. Jeder Aufruf ist ein POST an /cpi/<method> mit einem JSON-Body, der den Schlüssel enthält, und die Antwort ist { "code": ..., "data": ... }. Eine Ablehnung hat einen negativen code und einen Satz in data.

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

Was jeder Bildschirm tut, als Aufruf

Der Tarif wird im Dashboard im Tarif-Fenster gewählt. Dafür gibt es keine öffentliche Methode.

Deine Adressen lesen

ipv4_list antwortet mit einer Liste deiner Adressen in Adressreihenfolge. Jede hat:

ipv4_pool_status antwortet mit available, coming_soon, den prices nach internal, external und parked und den caps, die dein Tarif für internal und external erlaubt. Lies es vor einem Kauf: Wenn coming_soon true ist, ist nichts im Verkauf.

Eine Adresse kaufen

Finden, worauf sie zeigen kann

ipv4_attach_targets listet deine VPS, Deployments, Datacenter und Load Balancer auf, jeweils mit einer id, einem kind (vps, deployment, datacenter oder balancer) und einem label. Ein Workspace VPS ist nie ein Ziel für eine neue Adresse.

Sie kaufen

ipv4_purchase nimmt state (internal für ein Ding bei Xuda, external für deinen eigenen Server) und target_id. Gib bei internal die id aus der Liste an, mit ihrem kind und label. Gib bei external den Hostnamen deiner Maschine an. Die Standardkarte des Kontos wird mit der nächsten Rechnung belastet. Die Antwort ist die Zeile der neuen Adresse.

Sie benennen

ipv4_set_ptr nimmt die address und einen ptr-Hostnamen.

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')

Der Reverse-DNS-Name wird getrimmt und in Kleinbuchstaben gespeichert und muss ein Hostname mit einem Punkt sein, wie mail.example.com.

Verschieben, parken und freigeben

  • ipv4_attach lässt eine Adresse, die du hältst, auf ein anderes Ziel zeigen, mit target_type internal oder external, und wechselt ihren Zustand und ihren Preis. Die Rechnung wird anteilig berechnet.
  • ipv4_park hindert sie daran, etwas zu erreichen, und behält sie für dich zum Parkpreis.
  • ipv4_release gibt sie an den Pool zurück und beendet die Abrechnung. Die Antwort hat quarantine_until, den Tag, an dem sie in den Pool zurückkehrt. Du bekommst diese Adresse nicht zurück.

Wenn ein Aufruf abgelehnt wird

data sagt warum. Die Sätze, auf die es ankommt:

Die Abrechnung wird geprüft, bevor etwas reserviert wird. Wenn die Abrechnung nach einem Kauf nicht aktualisiert werden kann, wird die Reservierung rückgängig gemacht, daher hinterlässt ein abgelehnter Kauf keine Adresse.

Verbindungseinrichtung

ipv4_external_config antwortet mit mode, status und note für eine Adresse auf deinem eigenen Server. Heute lautet der Status pending: Die Schritte zum Einrichten des Tunnels und der Weiterleitung sind noch nicht fertig, und der Bildschirm sagt das. Ein Aufruf für eine Adresse, die nicht auf deinen eigenen Server zeigt, wird abgelehnt.

Wie findest du diese Anleitung?

Zuletzt aktualisiert am 16. November 2026