Commandes

Droit : orders:read.

GET /api/v1/orders

Paramètres : offset, limit, family, status, client_reference (correspondance exacte).

Une valeur inconnue de family ou status est lue comme « sans filtre ». L’ordre est fixe et non configurable : les plus récentes en premier.

Champ	Signification
product, kind, family	ce qui a été acheté ; kind : resident ou ipv4
quantity	nombre d’unités achetées : les adresses pour ipv4 ; pour une commande de trafic toujours 1 - un seul forfait a été acheté, et le volume se trouve dans packages[].traffic.purchased_gb
price_per_proxy, total	prix unitaire (total / quantity) et montant de la commande ; égaux pour une commande de trafic
status	voir ci-dessous
applied_to_package_id	non vide - la commande a été appliquée à un forfait existant : ajout de trafic ou prolongation d’adresses
client_reference	votre étiquette tirée du corps de l’achat
packages	le forfait de trafic délivré par la commande. Vide pour un ajout de trafic et pour les commandes d’adresses fixes - lisez leurs forfaits via GET /api/v1/packages?family=dedicated, la fiche contient order_id

GET /api/v1/orders/{id}

Même forme que dans la liste. Une commande d’un autre compte répond 404 sans clé code.

Statuts de délivrance

L’achat se termine à l’intérieur de la requête, donc dans la réponse de POST /api/v1/packages la commande est déjà completed. Les autres statuts apparaissent lors de la lecture des commandes.

Statut	Que faire
pending, provisioning	interroger toutes les 5-10 secondes
completed	prêt : le forfait de trafic est dans packages[0], le forfait d’adresses - dans le package_id de la réponse d’achat
failed	argent non débité ou remboursé, vous pouvez réessayer
refunded	argent remboursé sur décision de l’assistance ; réessayer comme un nouvel achat
needs_attention	argent débité, traité manuellement. Ne pas racheter, contacter l’assistance

Au lieu d’interroger les commandes, vous pouvez lire le journal des événements.