Siparişler

Yetki: orders:read.

GET /api/v1/orders

Parametreler: offset, limit, family, status, client_reference (tam eşleşme).

Bilinmeyen bir family veya status değeri “filtresiz” olarak okunur. Sıralama sabittir ve ayarlanamaz: en yeniler üstte.

Alan	Anlamı
product, kind, family	ne satın alındığı; kind: resident veya ipv4
quantity	satın alınan birim sayısı: ipv4 için adres sayısı; trafik siparişinde her zaman 1 - tek bir paket satın alınmıştır, hacim ise packages[].traffic.purchased_gb içindedir
price_per_proxy, total	birim fiyatı (total / quantity) ve sipariş tutarı; trafik siparişinde eşittir
status	aşağıya bakın
applied_to_package_id	doluysa - sipariş mevcut bir pakete uygulanmıştır: trafik hacmi ekleme veya adres uzatma
client_reference	satın alma gövdesindeki etiketiniz
packages	siparişin verdiği trafik paketi. Hacim eklemede ve sabit adres siparişlerinde boştur - bu paketleri GET /api/v1/packages?family=dedicated ile okuyun, kartta order_id bulunur

GET /api/v1/orders/{id}

Biçim listedekiyle aynıdır. Başka bir hesaba ait sipariş code anahtarı olmadan 404 ile yanıtlanır.

Sağlama durumları

Satın alma istek içinde tamamlanır, bu yüzden POST /api/v1/packages yanıtında sipariş zaten completed durumundadır. Diğer durumlar siparişler okunurken görülür.

Durum	Ne yapmalı
pending, provisioning	5-10 saniyede bir sorgulayın
completed	hazır: trafik paketi packages[0] içinde, adres paketi satın alma yanıtındaki package_id içinde
failed	para düşülmedi veya iade edildi, tekrar denenebilir
refunded	para destek kararıyla iade edildi; yeni bir satın alma olarak tekrarlayın
needs_attention	para düşüldü, elle inceleniyor. Tekrar satın almayın, desteğe başvurun

Siparişleri sorgulamak yerine olay günlüğünü okuyabilirsiniz.