Pesanan

Izin: orders:read.

GET /api/v1/orders

Parameter: offset, limit, family, status, client_reference (kecocokan persis).

Nilai family atau status yang tidak dikenal dibaca sebagai “tanpa filter”. Urutannya tetap dan tidak dapat diatur: yang terbaru di atas.

Field	Arti
product, kind, family	apa yang dibeli; kind: resident atau ipv4
quantity	jumlah unit yang dibeli: alamat untuk ipv4; untuk pesanan trafik selalu 1 - yang dibeli satu paket, sedangkan volumenya ada di packages[].traffic.purchased_gb
price_per_proxy, total	harga per unit (total / quantity) dan nilai pesanan; untuk pesanan trafik keduanya sama
status	lihat di bawah
applied_to_package_id	tidak kosong - pesanan diterapkan ke paket yang sudah ada: penambahan trafik atau perpanjangan alamat
client_reference	label Anda dari body pembelian
packages	paket trafik yang diberikan oleh pesanan. Kosong untuk penambahan volume dan untuk pesanan alamat tetap - baca paketnya melalui GET /api/v1/packages?family=dedicated, kartunya memuat order_id

GET /api/v1/orders/{id}

Bentuknya sama dengan di daftar. Pesanan milik akun lain dijawab 404 tanpa field code.

Status penyediaan

Pembelian selesai di dalam permintaan, sehingga dalam respons POST /api/v1/packages pesanan sudah completed. Status lainnya muncul saat membaca pesanan.

Status	Yang harus dilakukan
pending, provisioning	lakukan polling setiap 5-10 detik
completed	selesai: paket trafik ada di packages[0], paket alamat - di package_id dari respons pembelian
failed	dana tidak dipotong atau sudah dikembalikan, bisa diulang
refunded	dana dikembalikan atas keputusan dukungan; ulangi sebagai pembelian baru
needs_attention	dana sudah dipotong, ditangani secara manual. Jangan membeli ulang, hubungi dukungan

Alih-alih polling pesanan, Anda dapat membaca log peristiwa.