Güncel teslimat/kuyruk durumu

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

Yetkilendirme

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
Gerekli izin	`read`
Accept	`application/json`

Parametreler

Ad	Tür	Açıklama
`id` pathZorunlu	`integer`	Bu işleme ait kendi kayıt ID’niz; 1–2147483647. Görünen sipariş numarası veya sağlayıcı ID’si değildir. Sipariş kayıt ID’sidir.

İstek örneği

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'

Örnekler bu sayfada çalıştırılmaz. API anahtarını sunucu ortam değişkeninde tutun; gerçek anahtarı URL veya tarayıcı koduna yazmayın. POST örnekleri için request.json hazırlayın.

Yanıtlar

200Başarılı yanıt

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"
    }
}

Yanıt alanları ve türleri

Ad	Tür	Açıklama
`ok`	`boolean`	Başarılı istek zarfı; false ise error.code alanını okuyun.
`data`	`object`	İşleme özel sonuç. Örnekler temsili ve sentetiktir.
`data.order_id`	`integer`	İlgili ARNPROXY kayıt kimliği. Sağlayıcının iç kimliği yerine bunu kullanın.
`data.number`	`string`	Görünen sipariş numarası; API’de id isteyen alanlarla karıştırmayın.
`data.state`	`string`	Bu kaydın/işlemin durumu. accepted teslimat, completed bağlantı testi anlamına gelmez.
`data.reason_code`	`string\|null`	Sabit neden kodu veya null. Ham sağlayıcı hata metni değildir.
`data.quantity`	`integer`	Seçilen veya sipariş edilen proxy adedi.
`data.allocated_quantity`	`integer`	Yerel siparişe atanmış proxy sayısı; canlı bağlantı testi değildir.
`data.local_status_code`	`integer`	Sitenin mevcut sipariş durum kodu; teslimat değerlendirmesinde order_delivery kullanın.
`data.last_service_date`	`string`	Son hizmet günü; mevcut, önceki veya fiyatın öngördüğü tarih. Öngörü tek başına uzatma yapmaz.
`data.service_date_state`	`string`	Son hizmet gününün yerel tarihe göre past/not_past/unknown değerlendirmesi.
`data.queue_state`	`string`	Arka plan kuyruğunun yerel kayıtlı durumu/zamanı. Okumak işi yeniden başlatmaz.
`data.queue_updated_at`	`string`	Arka plan kuyruğunun yerel kayıtlı durumu/zamanı. Okumak işi yeniden başlatmaz.
`data.poll_after_seconds`	`integer\|null`	Önerilen tekrar sorgulama aralığı; aynı sipariş/işlem izlenir.
`data.timezone`	`string`	İlgili tarih alanlarının saat dilimi; null ise doğrulanmış bir dilim yoktur.
`data.source`	`string`	Bu alanın veri kaynağı; yerel kayıt ile canlı sağlayıcı okuması aynı şey değildir.
`data.provider_live_check`	`boolean`	Fiyat/yerel sonuç tek başına sağlayıcı veya stok garantisi değildir.
`data.automatic_retry_started`	`boolean`	Bu sorgu otomatik yeniden işlem başlatmış mı? Örnekte false.
`meta`	`object`	İstek izleme ve veri kaynağı bilgileri.
`meta.request_id`	`string`	Bu HTTP isteğinin kimliği; işlem anahtarı veya sipariş ID’si değildir.
`meta.phase`	`string`	phase alanının işleme özel değeri; örnekteki türü ve ilgili davranış notlarını esas alın.
`meta.source`	`string`	Bu alanın veri kaynağı; yerel kayıt ile canlı sağlayıcı okuması aynı şey değildir.

Hata yanıtı

HTTP 401 · INVALID_API_KEY

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

Kimlik doğrulama ve alan denetimleri işlemi başlamadan reddedebilir. Hata rehberini inceleyin; destek için request_id saklayın. Anahtar veya şifre göndermeyin. Hatalar ve limitler →

Davranış ve önemli notlar

id, ARNPROXY sipariş kayıt ID’sidir; görünen sipariş numarası değildir. Teslimat sorgusu sağlayıcıya canlı istek veya yeniden teslimat başlatmaz.