İçeriğe atla
Geliştirici dokümanlarıAPI referansıİşler

İşi getir

Bir işin durumu, ilerlemesi, özeti ve maliyeti.

GEThttps://runner.cargoduo.com/v1/jobs/{id}

status değeri succeeded, failed ya da canceled olana kadar 1–2 saniyede bir sorgulayın.

Kimlik doğrulama

Bearer API anahtarı, gereken yetki:jobs:readDaha fazla bilgi

Yol parametreleri

AdTürZorunluAçıklama
idstringzorunlu
string
Evet

İş ID'si (job_…).

Sorgu parametreleri

AdTürZorunluAçıklama
includestring
string
Hayır

result, iş başarıyla tamamlandığında yükleme planını yanıta ekler.

result

Örnek istek

curl -X GET "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Örnek yanıt

200 OK · Job
{
  "id": "job_4bK9mT2xQe7LpW1zRc8VdN3f",
  "object": "job",
  "status": "succeeded",
  "reference": "order-1042",
  "source": "api",
  "created_at": "2026-10-19T09:12:03Z",
  "started_at": "2026-10-19T09:12:03Z",
  "finished_at": "2026-10-19T09:12:07Z",
  "progress": {
    "stage": "done",
    "vehicles_done": 1,
    "placed_items": 58
  },
  "summary": {
    "items_requested": 58,
    "items_placed": 58,
    "items_unplaced": 0,
    "vehicles_used": 1,
    "total_weight": 8580,
    "volume_utilization": 0.3116,
    "queue_ms": 12,
    "compute_ms": 4210
  },
  "cost": {
    "credits": 0.28105,
    "reserved_credits": 1.11,
    "rate_card_version": 1,
    "breakdown": {
      "base": 0.06,
      "vehicles": 0.2,
      "compute": 0.02105,
      "large_load": 0
    }
  },
  "error": null,
  "warnings": [],
  "result_url": "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result",
  "pdf_url": "https://app.cargoduo.com/r/Xq7Lm2Vt9KbR4cN8wZp1Hs6Yd3Fg5Jk0Ta2Ue7Wn4Ci",
  "expires_at": "2026-11-02T09:12:03Z"
}

Yanıtlar

  • 200OKİş.
    AdTürZorunluAçıklama
    idstringzorunlu
    string
    Evet

    İş ID'si (job_…).

    objectstringzorunlu
    string
    Evet

    Her zaman job.

    job
    statusstringzorunlu
    string
    Evet

    queued → running → succeeded | failed | canceled.

    queuedrunningsucceededfailedcanceled
    referencestring
    string
    Hayır

    İstekte gönderdiğiniz referans.

    sourcestring
    string
    Hayır

    İşin oluşturulduğu yer.

    apiplayground
    project_idstring
    string
    Hayır

    POST /v1/projects/{id}/pack işinin planını kaydettiği proje (prj_…). Diğer işlerde bulunmaz.

    created_atstringzorunlu
    string
    Evet

    RFC 3339 zaman damgası.

    started_atstring | null
    string | null
    Hayır

    Hesaplamanın başladığı zaman (RFC 3339) ya da null.

    finished_atstring | null
    string | null
    Hayır

    İşin bittiği zaman (RFC 3339) ya da null.

    progressJobProgress
    JobProgress
    Hayır

    İş sıradayken ya da çalışırken anlık ilerleme.

    summaryJobSummary
    JobSummary
    Hayır

    Sayılar ve süreler.

    costJobCost
    JobCost
    Hayır

    Düşülen krediler (iş bitince kesinleşir) ve iş çalışırken tutulan rezervasyon.

    errorJobError | null
    JobError | null
    Hayır

    İşin neden başarısız olduğu ya da iptal edildiği; aksi halde null.

    warningsWarning[]
    Warning[]
    Hayır

    İstekle ilgili engelleyici olmayan uyarılar (sonuçta da yinelenir).

    result_urlstring
    string
    Hayır

    status değeri succeeded olduğunda tam sonuç için bu URL'ye GET isteği gönderin.

    pdf_urlstring
    string
    Hayır

    Yükleme planını PDF olarak oluşturan tarayıcı bağlantısı (3B görünümler + yükleme adımları). expires_at zamanına kadar geçerlidir. Süresi dolunca boştur.

    expires_atstring
    string
    Hayır

    İstek/sonuç gövdelerinin ve PDF bağlantısının silineceği zaman (RFC 3339). İşin meta verileri ve ücretleri saklanır.

    resultResult
    Result
    Hayır

    Tam sonuç; yalnızca istendiğinde (?include=result) ya da POST /v1/pack?wait= zamanında bittiğinde yanıtın içinde gelir.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedAPI anahtarı eksik, hatalı biçimde ya da tanınmıyor.
    • key_revokedAnahtar iptal edildi.
    • key_expiredAnahtarın geçerlilik süresi doldu.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedİsteği gönderen IP, anahtarın izin listesinde değil.
    • subscription_inactiveOrganizasyonun API'yi içeren etkin bir aboneliği yok.
    • account_inactiveOrganizasyon askıya alınmış ya da hesabı etkin olan bir organizasyon sahibi yok.
    • scope_missingAnahtarda bu endpoint'in gerektirdiği bir yetki eksik.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 404Not foundjob_not_found
    • job_not_foundOrganizasyonunuzda bu ID'ye sahip bir iş yok.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 429Too many requestsrate_limited
    • rate_limitedGeçerli dakika, saat ya da gün içinde çok fazla istek gönderildi (anahtar ya da organizasyon başına) veya IP adresinizden gelen başarısız kimlik doğrulama denemeleri dakikada 60 sınırını aştı.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 500Internal server errorinternal_error
    • internal_errorBizim tarafımızda bir hata oluştu.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 503Service unavailableapi_disabled
    • api_disabledAPI geçici olarak devre dışı (bakım) ya da organizasyon için kapatılmış.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları