Geliştirici dokümanlarıAPI referansı
Genel bakış
Temel URL, kurallar ve tüm endpoint'ler.
https://runner.cargoduo.com/v1HTTPS üzerinden JSON. Uzunluklar cm, ağırlıklar kg, tutarlar kredi cinsindendir.
Endpoint'ler
Yükleme
| Endpoint | Sayfa | Yetki |
|---|---|---|
POST /v1/pack | Yükleme işi oluştur | pack:write |
POST /v1/estimate | Maliyet tahmini al | pack:write |
İşler
| Endpoint | Sayfa | Yetki |
|---|---|---|
GET /v1/jobs | İşleri listele | jobs:read |
GET /v1/jobs/{id} | İşi getir | jobs:read |
GET /v1/jobs/{id}/result | İş sonucunu getir | jobs:read |
DELETE /v1/jobs/{id} | İşi iptal et | pack:write |
Projeler
| Endpoint | Sayfa | Yetki |
|---|---|---|
GET /v1/projects | Projeleri listele | resources:read |
POST /v1/projects | Proje oluştur | resources:write |
GET /v1/projects/{id} | Projeyi getir | resources:read |
PATCH /v1/projects/{id} | Projeyi güncelle | resources:write |
DELETE /v1/projects/{id} | Projeyi sil | resources:write |
POST /v1/projects/{id}/pack | Projeyi hesapla | pack:write ve resources:write |
Araçlar
| Endpoint | Sayfa | Yetki |
|---|---|---|
GET /v1/vehicles | Araçları listele | resources:read |
GET /v1/vehicles/{id} | Aracı getir | resources:read |
POST /v1/vehicles | Araç oluştur | resources:write |
PATCH /v1/vehicles/{id} | Aracı güncelle | resources:write |
DELETE /v1/vehicles/{id} | Aracı sil | resources:write |
Şablonlar
| Endpoint | Sayfa | Yetki |
|---|---|---|
GET /v1/templates | Şablonları listele | resources:read |
GET /v1/templates/{id} | Şablonu getir | resources:read |
POST /v1/templates | Şablon oluştur | resources:write |
PATCH /v1/templates/{id} | Şablonu güncelle | resources:write |
DELETE /v1/templates/{id} | Şablonu sil | resources:write |
Hesap
| Endpoint | Sayfa | Yetki |
|---|---|---|
GET /v1/limits | Limitleri getir | account:read |
GET /v1/balance | Bakiyeyi getir | account:read |
GET /v1/usage | Kullanımı getir | account:read |
Header'lar
| Header | Yön | Anlamı |
|---|---|---|
Authorization | İstek | Bearer cd_live_… |
Content-Type | İstek | POST isteklerinde application/json |
Idempotency-Key | İstek | POST /v1/pack ve POST /v1/projects/{id}/pack için güvenli tekrar deneme |
X-Request-Id | Yanıt | İstek ID'si (req_…), her yanıtta |
X-RateLimit-Limit / -Remaining / -Reset | Yanıt | En sıkı rate limit penceresi |
X-Credits-Remaining | Yanıt | İstekten sonra kalan kullanılabilir kredi |
Retry-After | Yanıt | 429 yanıtında beklenecek saniye |
Idempotent-Replayed | Yanıt | Anahtar önceki bir işi tekrar döndürdüğünde true |
Makine tarafından okunabilir
openapi.jsonOpenAPI 3.1, tüm endpoint'ler ve şemalar.llms-full.txtyapay zekâ kodlama ajanları için entegrasyon rehberi.