Aller au contenu

IPv4 Manager

Des adresses IPv4 dédiées pour ce que vous hébergez.

Ouvrir IPv4 Manager
Vérifié par rapport au tableau de bord le 18 novembre 2026

Tout ce que l'IPv4 Manager fait avec vos adresses a une méthode. Toutes agissent sur votre propre compte et demandent votre clé API. Chaque appel est un POST vers /cpi/<method> avec un corps JSON qui porte la clé, et la réponse est { "code": ..., "data": ... }. Un refus a un code négatif et une phrase dans data.

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

Ce que fait chaque écran, sous forme d'appel

Le forfait se choisit dans le tableau de bord, depuis la fenêtre des forfaits. Il n'a aucune méthode publique.

Lire vos adresses

ipv4_list répond par une liste de vos adresses, dans l'ordre des adresses. Chacune a :

ipv4_pool_status répond available, coming_soon, les prices par internal, external et parked, et les caps que votre forfait permet sur internal et external. Lisez-le avant un achat : quand coming_soon vaut true, rien n'est en vente.

Acheter une adresse

Trouvez ce vers quoi elle peut pointer

ipv4_attach_targets liste vos VPS, déploiements, centres de données et équilibreurs de charge, chacun avec un id, un kind (vps, deployment, datacenter ou balancer) et un label. Un VPS d'espace de travail n'est jamais une cible pour une nouvelle adresse.

Achetez-la

ipv4_purchase prend state (internal pour un élément sur Xuda, external pour votre propre serveur) et target_id. Pour internal, donnez l'id de la liste, avec son kind et son label. Pour external, donnez le nom d'hôte de votre machine. La carte par défaut du compte est prélevée sur sa prochaine facture. La réponse est la ligne de la nouvelle adresse.

Nommez-la

ipv4_set_ptr prend l'address et un nom d'hôte 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')

Le nom DNS inversé est enregistré sans espaces superflus et en minuscules, et doit être un nom d'hôte avec un point, comme mail.example.com.

Déplacer, réserver et libérer

  • ipv4_attach fait pointer une adresse que vous détenez vers une autre cible, avec target_type internal ou external, ce qui change son état et son tarif. La facture est calculée au prorata.
  • ipv4_park l'empêche d'atteindre quoi que ce soit et la garde pour vous au tarif de réservation.
  • ipv4_release la remet dans le pool et arrête la facturation. La réponse contient quarantine_until, le jour où elle revient dans le pool. Vous ne pouvez pas récupérer cette adresse.

Quand un appel est refusé

data dit pourquoi. Les phrases qui comptent :

La facturation est vérifiée avant que quoi que ce soit soit réclamé. Si la facturation ne peut pas être mise à jour après un achat, la réclamation est annulée, donc un achat refusé ne laisse aucune adresse.

Configuration de la connexion

ipv4_external_config répond mode, status et note pour une adresse sur votre propre serveur. Aujourd'hui, le statut indique pending : les étapes pour configurer le tunnel et la redirection ne sont pas encore prêtes, et l'écran le dit. Un appel pour une adresse qui ne pointe pas vers votre propre serveur est refusé.

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026