Bakiye Mutabakatı
Excel Dışa Aktarımı Hazırlama(requestCampaignExport)
POST/balance-campaigns/{id}/exports
Excel dışa aktarımı hazırla
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
Arka planda dosya üretilir; export_id ile GET …/exports/{export_id} sorgulanır. Tek indirmelik.
Servis
| Metot | POST |
| Adres | https://mutabakat.ai/api/v1/balance-campaigns/{id}/exports |
| Kapsam | balance:read |
| Idempotency-Key | Kabul edilir (önerilir) |
| dry_run | Destekleniyor (?dry_run=true) |
İstek Parametreleri
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| id (yol) | string (uuid) | Evet | Kampanya kimliği |
| format (sorgu) | "xlsx" | Hayır | Yalnız xlsx |
| dry_run (sorgu) | "true" | Hayır | true ise hiçbir şey yazılmaz; doğrulama + "ne olacak" raporu döner (yalnız bu yazım). |
| Idempotency-Key (başlık) | string | Hayır | Aynı anahtar + aynı gövde 24 saat boyunca aynı yanıtı verir (Idempotency-Replayed: true); aynı anahtar farklı gövde 409. Toplu yazma uçlarında zorunlu. |
İstek Gövdesi
Gövde alanı yoktur; boş gövde ya da {} gönderin.
Yanıt
202Hazırlanıyor
| Alan | Tür | Açıklama |
|---|---|---|
| export_id | string | |
| status | "preparing" | |
| request_id | RequestId |
Hata Kodları
Bu uç için dönebilecek HTTP durumları: 400 · 401 · 403 · 404 · 422 · 429 · 500 · 503. Zarf biçimi ve kod listesi için Hata Kodları sayfasına bakın.
Örnek İstek
curl -X POST https://mutabakat.ai/api/v1/balance-campaigns/<id>/exports \
-H "Authorization: Bearer $MAI_API_KEY"