Status pengiriman

GET/account/api/v1/orders/{id}/delivery

Otorisasi

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
Izin yang diperlukan	`read`
Accept	`application/json`

Parameter

Nama	Tipe	Keterangan
`id` pathWajib	`integer`	ID catatan milik sendiri untuk operasi ini; 1–2147483647. Bukan nomor pesanan tampilan atau ID penyedia.

Contoh permintaan

cURL

printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    'https://www.arnproxy.com/account/api/v1/orders/YOUR_ORDER_ID/delivery'

Contoh tidak dijalankan di halaman ini. Simpan kunci API dalam variabel lingkungan server, bukan URL atau kode browser. Siapkan request.json untuk contoh POST.

Respons

200Respons berhasil

application/json

{
    "ok": true,
    "data": {
        "order_id": 10001,
        "number": "1000010001",
        "state": "delivered",
        "reason_code": null,
        "quantity": 1,
        "allocated_quantity": 1,
        "local_status_code": 1,
        "last_service_date": "2030-02-01",
        "service_date_state": "not_past",
        "queue_state": "success",
        "queue_updated_at": "2030-01-01 15:00:00",
        "poll_after_seconds": null,
        "timezone": "Europe/Istanbul",
        "source": "arnproxy_records",
        "provider_live_check": false,
        "automatic_retry_started": false
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

Kolom dan tipe respons

Nama	Tipe	Keterangan
`ok`	`boolean`	Penanda berhasil; jika false, periksa error.code.
`data`	`object`	Hasil khusus operasi; contoh bersifat ilustratif dan sintetis.
`data.order_id`	`integer`	ID catatan ARNPROXY terkait; gunakan alih-alih ID internal penyedia.
`data.number`	`string`	Nomor pesanan tampilan; tidak sama dengan kolom yang meminta id.
`data.state`	`string`	Status catatan/operasi. accepted bukan terkirim; completed bukan tes koneksi.
`data.reason_code`	`string\|null`	Kode alasan tetap atau null, bukan teks kesalahan penyedia mentah.
`data.quantity`	`integer`	Jumlah proxy terpilih atau dipesan.
`data.allocated_quantity`	`integer`	Jumlah proxy dialokasikan lokal, bukan tes koneksi langsung.
`data.local_status_code`	`integer`	Kode status pesanan situs; gunakan order_delivery untuk menilai pengiriman.
`data.last_service_date`	`string`	Hari layanan terakhir: saat ini, sebelumnya, atau proyeksi harga. Proyeksi tidak memperpanjang.
`data.service_date_state`	`string`	Penilaian past/not_past/unknown atas hari layanan terakhir lokal.
`data.queue_state`	`string`	Status/waktu antrean latar tersimpan; membaca tidak memulai ulang pekerjaan.
`data.queue_updated_at`	`string`	Status/waktu antrean latar tersimpan; membaca tidak memulai ulang pekerjaan.
`data.poll_after_seconds`	`integer\|null`	Jeda polling yang disarankan; lacak pesanan/operasi yang sama.
`data.timezone`	`string`	Zona waktu kolom tanggal terkait; null berarti belum terverifikasi.
`data.source`	`string`	Sumber data; catatan lokal dan kueri penyedia langsung merupakan bukti berbeda.
`data.provider_live_check`	`boolean`	Harga/hasil lokal sendiri bukan jaminan penyedia atau stok.
`data.automatic_retry_started`	`boolean`	Apakah kueri ini memulai percobaan ulang otomatis; contoh false.
`meta`	`object`	Metadata korelasi permintaan dan sumber data.
`meta.request_id`	`string`	ID korelasi permintaan HTTP ini, bukan kunci operasi atau ID pesanan.
`meta.phase`	`string`	Nilai khusus operasi untuk phase. Pertahankan tipe yang dikembalikan dan baca catatan perilaku.
`meta.source`	`string`	Sumber data; catatan lokal dan kueri penyedia langsung merupakan bukti berbeda.

Respons kesalahan

HTTP 401 · INVALID_API_KEY

{
  "ok": false,
  "error": { "code": "INVALID_API_KEY" },
  "meta": { "request_id": "000000000000000000000001" }
}

Autentikasi dan validasi dapat menolak permintaan sebelum dijalankan. Lihat referensi kesalahan dan simpan request_id untuk dukungan. Jangan kirim kunci atau kata sandi. Kesalahan & batas →

Perilaku & catatan penting

id ialah ID catatan pesanan ARNPROXY, bukan nomor tampilan. Kueri pengiriman tidak memulai pemeriksaan penyedia langsung atau pengiriman ulang.