Saltar al contenido

IPv4 Manager

Direcciones IPv4 dedicadas para lo que alojas.

Abrir IPv4 Manager
Comprobado con el panel el 18 de noviembre de 2026

Todo lo que hace el IPv4 Manager con tus direcciones tiene un método. Todos actúan sobre tu propia cuenta y necesitan tu clave de API. Cada llamada es un POST a /cpi/<method> con un cuerpo JSON que lleva la clave, y la respuesta es { "code": ..., "data": ... }. Un rechazo tiene un code negativo y una frase en data.

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

Lo que hace cada pantalla, como llamada

El plan se elige en el dashboard, desde la ventana de planes. No tiene método público.

Leer tus direcciones

ipv4_list responde con una lista de tus direcciones en orden de dirección. Cada una tiene:

ipv4_pool_status responde available, coming_soon, los prices por internal, external y parked, y los caps que tu plan permite en internal y external. Léelo antes de una compra: cuando coming_soon es verdadero, nada está a la venta.

Comprar una dirección

Busca a qué puede apuntar

ipv4_attach_targets enumera tus VPS, despliegues, datacenters y balanceadores de carga, cada uno con un id, un kind (vps, deployment, datacenter o balancer) y un label. Un VPS del espacio de trabajo nunca es un destino para una dirección nueva.

Cómprala

ipv4_purchase toma state (internal para algo en Xuda, external para tu propio servidor) y target_id. Para internal, da el id de la lista, con su kind y label. Para external, da el nombre de host de tu máquina. La tarjeta predeterminada de la cuenta se cobra en su próxima factura. La respuesta es la fila de la dirección nueva.

Ponle nombre

ipv4_set_ptr toma el address y un nombre 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')

El nombre de DNS inverso se guarda recortado y en minúsculas, y debe ser un nombre de host con un punto, como mail.example.com.

Mover, reservar y liberar

  • ipv4_attach apunta una dirección que tienes a otro destino, con target_type internal o external, cambiando su estado y su tarifa. La factura se prorratea.
  • ipv4_park detiene que llegue a nada y la guarda para ti a la tarifa de aparcado.
  • ipv4_release la devuelve al fondo común y detiene la facturación. La respuesta tiene quarantine_until, el día en que vuelve al fondo común. No puedes recuperar esa dirección.

Cuando se rechaza una llamada

data dice por qué. Las frases que importan:

La facturación se comprueba antes de reclamar nada. Si la facturación no se puede actualizar después de una compra, la reclamación se deshace, así que una compra rechazada no deja ninguna dirección.

Configuración de la conexión

ipv4_external_config responde mode, status y note para una dirección en tu propio servidor. Hoy el estado dice pending: los pasos para configurar el túnel y el reenvío todavía no están listos, y la pantalla lo dice. Una llamada para una dirección que no apunta a tu propio servidor se rechaza.

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026