{"openapi":"3.1.0","info":{"title":"Bağla API","version":"0.3.0","description":"Bağla asistanını kendi sisteminden yönet: arama listeleri, kişiler, aranmayacaklar, otomatik arama kuyruğu, görüşmeler ve webhook’lar. Her yanıt JSON; hatalar `{ \"error\": \"...\" }` biçiminde Türkçe bir cümledir.","x-docs":"https://docs.bagla.ai"},"servers":[{"url":"https://app.bagla.ai/api/v1"}],"tags":[{"name":"Genel","description":"Anahtar ve işletme bilgisi"},{"name":"Arama listeleri","description":"Liste kurma, çalışma saatleri, numaralar, durum"},{"name":"Kişiler","description":"Alıcı havuzu, liste üyelikleri, toplu işlemler ve CSV"},{"name":"Numaralar","description":"Giden arama numara havuzu"},{"name":"Aranmayacaklar","description":"Aranmayacaklar listesi"},{"name":"Otomatik arama","description":"Tek kuyruğa kişi basıp sırayla aratma"},{"name":"Görüşmeler","description":"Görüşme listesi, döküm, ses kaydı"},{"name":"Raporlar","description":"Özet raporlar"},{"name":"Webhook’lar","description":"Webhook yönetimi, teslimatlar, olay geçmişi"},{"name":"OpenAPI","description":"Makine okunur tanım"}],"security":[{"bearerAuth":[]}],"paths":{"/me":{"get":{"operationId":"getMe","tags":["Genel"],"summary":"Anahtarın bağlı olduğu işletme ve anahtar bilgisi","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","tags":["OpenAPI"],"summary":"Bu tanımın JSON hâli (anahtar gerekmez)","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}}},"security":[]}},"/call-lists/meta":{"get":{"operationId":"getCallListMeta","tags":["Arama listeleri"],"summary":"Saat sınırları, durumlar, toplu işlem sınırları","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/call-lists":{"get":{"operationId":"listCallLists","tags":["Arama listeleri"],"summary":"Listeleri sayfalı döner","parameters":[{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","passive","draft","ready","running","paused","done"]}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"post":{"operationId":"createCallList","tags":["Arama listeleri"],"summary":"Liste oluşturur","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"Doğrulama hatası"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"409":{"$ref":"#/components/responses/Error","description":"Aynı adda liste var"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"purpose":{"type":"string","minLength":10,"maxLength":1000},"greeting":{"default":"","type":"string","maxLength":1000},"consentBasis":{"type":"string","enum":["b2b","consent"]},"timezone":{"type":"string","minLength":1,"maxLength":64},"activeFrom":{"nullable":true,"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"activeUntil":{"nullable":true,"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"schedule":{"maxItems":56,"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["weekday","start","end"]}},"days":{"maxItems":7,"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"ranges":{"maxItems":8,"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}]},"minItems":2,"maxItems":2}},"numberIds":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":3,"maxLength":32}},"maxAttempts":{"default":2,"type":"integer","minimum":1,"maximum":5},"retryMinutes":{"default":120,"type":"integer","minimum":5,"maximum":10080},"concurrency":{"default":1,"type":"integer","minimum":1,"maximum":10},"contactIds":{"maxItems":5000,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}},"contacts":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"default":"","type":"string","maxLength":80},"company":{"default":"","type":"string","maxLength":120},"note":{"default":"","type":"string","maxLength":300},"fields":{"default":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}},"externalId":{"type":"string","maxLength":100},"listIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["phone"]}}},"required":["name","purpose","consentBasis"]}}}}}},"/call-lists/{id}":{"get":{"operationId":"getCallList","tags":["Arama listeleri"],"summary":"Liste detayı: ayarlar, sayılar, numaralar, durum","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"put":{"operationId":"updateCallList","tags":["Arama listeleri"],"summary":"Verilen alanları günceller; gönderilmeyenler korunur","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"409":{"$ref":"#/components/responses/Error","description":"Aynı adda liste var"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"purpose":{"type":"string","minLength":10,"maxLength":1000},"greeting":{"default":"","type":"string","maxLength":1000},"consentBasis":{"type":"string","enum":["b2b","consent"]},"timezone":{"type":"string","minLength":1,"maxLength":64},"activeFrom":{"nullable":true,"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"activeUntil":{"nullable":true,"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"schedule":{"maxItems":56,"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["weekday","start","end"]}},"days":{"maxItems":7,"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"ranges":{"maxItems":8,"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}]},"minItems":2,"maxItems":2}},"numberIds":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":3,"maxLength":32}},"maxAttempts":{"default":2,"type":"integer","minimum":1,"maximum":5},"retryMinutes":{"default":120,"type":"integer","minimum":5,"maximum":10080},"concurrency":{"default":1,"type":"integer","minimum":1,"maximum":10}}}}}}},"delete":{"operationId":"deleteCallList","tags":["Arama listeleri"],"summary":"Listeyi ve üyeliklerini siler","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"409":{"$ref":"#/components/responses/Error","description":"Çalışan liste silinemez"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/call-lists/{id}/activate":{"post":{"operationId":"activateCallList","tags":["Arama listeleri"],"summary":"Listeyi aktif yapar","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"Hat ya da aranacak kişi yok"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/call-lists/{id}/deactivate":{"post":{"operationId":"deactivateCallList","tags":["Arama listeleri"],"summary":"Listeyi pasif yapar","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/call-lists/{id}/schedule":{"get":{"operationId":"getCallListSchedule","tags":["Arama listeleri"],"summary":"Çalışma programı, açık mı, sonraki açılış","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"put":{"operationId":"updateCallListSchedule","tags":["Arama listeleri"],"summary":"Programı, saat dilimini ve etkin tarihleri değiştirir","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"Çakışan ya da sınır dışı aralık"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"schedule":{"maxItems":56,"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["weekday","start","end"]}},"days":{"maxItems":7,"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"ranges":{"maxItems":8,"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}]},"minItems":2,"maxItems":2}},"timezone":{"type":"string","minLength":1,"maxLength":64},"activeFrom":{"nullable":true,"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"activeUntil":{"nullable":true,"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}}}}}}},"/call-lists/{id}/numbers":{"get":{"operationId":"getCallListNumbers","tags":["Arama listeleri"],"summary":"Listeye atanmış numaralar","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"put":{"operationId":"updateCallListNumbers","tags":["Arama listeleri"],"summary":"Numaraları değiştirir","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"Havuzda olmayan numara"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"numberIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":3,"maxLength":32}},"strategy":{"default":"round_robin","type":"string","enum":["round_robin","random","first"]}},"required":["numberIds"]}}}}}},"/call-lists/{id}/contacts":{"get":{"operationId":"listCallListContacts","tags":["Kişiler"],"summary":"Liste üyeleri ve arama durumları","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"},{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"updatedSince","in":"query","required":false,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"post":{"operationId":"addCallListContacts","tags":["Kişiler"],"summary":"Listeye kişi ekler (JSON ya da CSV)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"409":{"$ref":"#/components/responses/Error","description":"Tamamlanmış liste"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"update":{"default":false,"type":"boolean"},"contactIds":{"maxItems":5000,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}},"contacts":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"default":"","type":"string","maxLength":80},"company":{"default":"","type":"string","maxLength":120},"note":{"default":"","type":"string","maxLength":300},"fields":{"default":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}},"externalId":{"type":"string","maxLength":100}},"required":["phone"]}}}}},"text/csv":{"schema":{"type":"string"},"example":"telefon;ad;firma;not\n0532 000 00 01;Ayşe Yılmaz;Örnek Ltd;Demo istedi"}}}},"delete":{"operationId":"removeCallListContacts","tags":["Kişiler"],"summary":"Kişileri listeden çıkarır","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"409":{"$ref":"#/components/responses/Error","description":"Şu an aranan kişi"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contactIds":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["contactIds"]}}}}}},"/call-lists/{id}/contacts/{contactId}":{"delete":{"operationId":"removeCallListContact","tags":["Kişiler"],"summary":"Tek kişiyi listeden çıkarır","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"},{"name":"contactId","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste ya da kişi yok"},"409":{"$ref":"#/components/responses/Error","description":"Şu an aranan kişi"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/call-lists/{id}/import":{"post":{"operationId":"importCallListCsv","tags":["Kişiler"],"summary":"CSV’yi içe aktarır ve bu listeye ekler","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":5000000},"preview":{"default":false,"type":"boolean"},"update":{"default":false,"type":"boolean"},"listIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["text"]}},"text/csv":{"schema":{"type":"string"},"example":"telefon;ad;firma;not\n0532 000 00 01;Ayşe Yılmaz;Örnek Ltd;Demo istedi"}}}}},"/contacts":{"get":{"operationId":"listContacts","tags":["Kişiler"],"summary":"Tüm kişiler (havuz görünümü)","parameters":[{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"listId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f\\d]{24}$"}},{"name":"notInList","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f\\d]{24}$"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["name","oldest","newest"]}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"post":{"operationId":"createContacts","tags":["Kişiler"],"summary":"Tek kişi ya da { contacts: [...] } ile toplu ekleme","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"listIds gerekli ya da doğrulama hatası"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"409":{"$ref":"#/components/responses/Error","description":"Aynı telefon zaten listede"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"default":"","type":"string","maxLength":80},"company":{"default":"","type":"string","maxLength":120},"note":{"default":"","type":"string","maxLength":300},"fields":{"default":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}},"externalId":{"type":"string","maxLength":100},"listIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["phone"]},{"type":"object","properties":{"update":{"default":false,"type":"boolean"},"listIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}},"contacts":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"default":"","type":"string","maxLength":80},"company":{"default":"","type":"string","maxLength":120},"note":{"default":"","type":"string","maxLength":300},"fields":{"default":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}},"externalId":{"type":"string","maxLength":100}},"required":["phone"]}}},"required":["contacts"]}]}}}}}},"/contacts/{id}":{"get":{"operationId":"getContact","tags":["Kişiler"],"summary":"Kişi ve üye olduğu listeler","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Kişi yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"put":{"operationId":"updateContact","tags":["Kişiler"],"summary":"Kişiyi günceller; aranmamış tüm üyeliklere yansır","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Kişi yok"},"409":{"$ref":"#/components/responses/Error","description":"Şu an aranıyor ya da numara çakışıyor"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"type":"string","maxLength":80},"company":{"type":"string","maxLength":120},"note":{"type":"string","maxLength":300},"fields":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}},"externalId":{"nullable":true,"type":"string","maxLength":100}}}}}}},"delete":{"operationId":"deleteContact","tags":["Kişiler"],"summary":"Kişiyi ve tüm üyeliklerini siler","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Kişi yok"},"409":{"$ref":"#/components/responses/Error","description":"Şu an aranıyor"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/contacts/assign":{"post":{"operationId":"assignContacts","tags":["Kişiler"],"summary":"Kişileri listelere ekler","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Liste yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contactIds":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}},"listIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["contactIds","listIds"]}}}}}},"/contacts/unassign":{"post":{"operationId":"unassignContacts","tags":["Kişiler"],"summary":"Kişileri listelerden çıkarır","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"409":{"$ref":"#/components/responses/Error","description":"Şu an aranan kişi"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contactIds":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}},"listIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["contactIds","listIds"]}}}}}},"/contacts/bulk":{"patch":{"operationId":"bulkUpdateContacts","tags":["Kişiler"],"summary":"Toplu güncelleme (id ya da match ile)","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"updates":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"company":{"type":"string","maxLength":120},"note":{"type":"string","maxLength":300},"fields":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}},"externalId":{"nullable":true,"type":"string","maxLength":100},"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"match":{"type":"string","minLength":10,"maxLength":20}}}}},"required":["updates"]}}}}}},"/contacts/bulk-delete":{"post":{"operationId":"bulkDeleteContacts","tags":["Kişiler"],"summary":"Toplu silme","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["ids"]}}}}}},"/contacts/import":{"post":{"operationId":"importContactsCsv","tags":["Kişiler"],"summary":"CSV içe aktarma (listIds ile)","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"listIds gerekli"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":5000000},"preview":{"default":false,"type":"boolean"},"update":{"default":false,"type":"boolean"},"listIds":{"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-f\\d]{24}$"}}},"required":["text"]}},"text/csv":{"schema":{"type":"string"},"example":"telefon;ad;firma;not\n0532 000 00 01;Ayşe Yılmaz;Örnek Ltd;Demo istedi"}}}}},"/call-numbers":{"get":{"operationId":"listCallNumbers","tags":["Numaralar"],"summary":"Havuzdaki numaralar","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/call-numbers/{id}":{"put":{"operationId":"updateCallNumber","tags":["Numaralar"],"summary":"Numarayı etkinleştirir/devre dışı bırakır, etiketi değiştirir","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Numara yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"label":{"type":"string","maxLength":60}}}}}}}},"/do-not-call":{"get":{"operationId":"listDoNotCall","tags":["Aranmayacaklar"],"summary":"Liste (en yeni önce)","parameters":[{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["assistant","panel","api"]}},{"name":"since","in":"query","required":false,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"post":{"operationId":"addDoNotCall","tags":["Aranmayacaklar"],"summary":"Numara ekler (tek ya da toplu)","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"200":{"description":"Zaten listedeydi","content":{"application/json":{"schema":{}}}},"201":{"description":"Eklendi","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"reason":{"default":"","type":"string","maxLength":200}},"required":["phone"]},{"type":"object","properties":{"phones":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"string","maxLength":32}},"reason":{"default":"","type":"string","maxLength":200}},"required":["phones"]},{"type":"object","properties":{"numbers":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","maxLength":32},"reason":{"default":"","type":"string","maxLength":200}},"required":["phone"]}}},"required":["numbers"]}]}}}}}},"/do-not-call/check":{"post":{"operationId":"checkDoNotCall","tags":["Aranmayacaklar"],"summary":"Hangi numaralar listede?","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phones":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","maxLength":32}}},"required":["phones"]}}}}}},"/do-not-call/{phone}":{"get":{"operationId":"getDoNotCall","tags":["Aranmayacaklar"],"summary":"Tek numara: listede mi, kaydı nedir","parameters":[{"name":"phone","in":"path","required":true,"schema":{"type":"string"},"description":"Telefon numarası (her yazım kabul edilir)"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Listede değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"delete":{"operationId":"removeDoNotCall","tags":["Aranmayacaklar"],"summary":"Numarayı listeden çıkarır","parameters":[{"name":"phone","in":"path","required":true,"schema":{"type":"string"},"description":"Telefon numarası (her yazım kabul edilir)"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Listede değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/outbound/contacts":{"get":{"operationId":"listQueueContacts","tags":["Otomatik arama"],"summary":"Kuyruktaki kişiler ve sonuçları","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"post":{"operationId":"pushQueueContacts","tags":["Otomatik arama"],"summary":"Kuyruğa kişi basar (JSON ya da CSV)","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"201":{"description":"Eklendi","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"Kuyruk ya da istek sınırı aşıldı"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"contacts":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"default":"","type":"string","maxLength":80},"company":{"default":"","type":"string","maxLength":120},"note":{"default":"","type":"string","maxLength":300},"externalId":{"type":"string","maxLength":100},"fields":{"default":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}}},"required":["phone"]}}},"required":["contacts"]},{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"default":"","type":"string","maxLength":80},"company":{"default":"","type":"string","maxLength":120},"note":{"default":"","type":"string","maxLength":300},"externalId":{"type":"string","maxLength":100},"fields":{"default":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}}},"required":["phone"]}},{"type":"object","properties":{"phone":{"type":"string","minLength":10,"maxLength":20},"name":{"default":"","type":"string","maxLength":80},"company":{"default":"","type":"string","maxLength":120},"note":{"default":"","type":"string","maxLength":300},"externalId":{"type":"string","maxLength":100},"fields":{"default":{},"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":200},{"type":"number"},{"type":"boolean"},{"type":"string","nullable":true,"enum":[null]}]}}},"required":["phone"]}]}},"text/csv":{"schema":{"type":"string"},"example":"telefon;ad;firma;not\n0532 000 00 01;Ayşe Yılmaz;Örnek Ltd;Demo istedi"}}}}},"/outbound/contacts/{id}":{"get":{"operationId":"getQueueContact","tags":["Otomatik arama"],"summary":"Tek kişi, görüşme özeti ve dökümüyle ({id} ya da externalId)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Kişi yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"delete":{"operationId":"deleteQueueContact","tags":["Otomatik arama"],"summary":"Kişiyi kuyruktan çıkarır (yalnızca pending)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Kişi yok"},"409":{"$ref":"#/components/responses/Error","description":"Aranmış kişi"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/outbound/campaign":{"get":{"operationId":"getQueue","tags":["Otomatik arama"],"summary":"Kuyruk ayarları, durumu ve sayıları","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/outbound/campaign/start":{"post":{"operationId":"startQueue","tags":["Otomatik arama"],"summary":"Kuyruğu başlatır","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"Hat yok"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"409":{"$ref":"#/components/responses/Error","description":"Otomatik arama ayarlanmamış"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/outbound/campaign/pause":{"post":{"operationId":"pauseQueue","tags":["Otomatik arama"],"summary":"Kuyruğu duraklatır","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"402":{"$ref":"#/components/responses/Error","description":"Giden arama bu planda kullanılamıyor"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/outbound/live":{"get":{"operationId":"getQueueLive","tags":["Otomatik arama"],"summary":"Şu an aranan kişiler","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/outbound/report":{"get":{"operationId":"getQueueReport","tags":["Otomatik arama"],"summary":"Kuyruk raporu (varsayılan son 30 gün)","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/calls":{"get":{"operationId":"listCalls","tags":["Görüşmeler"],"summary":"Görüşme listesi","parameters":[{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string","enum":["inbound","outbound"]}},{"name":"outcome","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"before","in":"query","required":false,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/calls/{id}":{"get":{"operationId":"getCall","tags":["Görüşmeler"],"summary":"Özet ve konuşma dökümü","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Görüşme yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/calls/{id}/recording":{"get":{"operationId":"getCallRecording","tags":["Görüşmeler"],"summary":"Ses kaydını indirir (audio/*)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"audio/*":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Kayıt yok ya da henüz hazır değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 20 indirme aşıldı"}}}},"/reports/summary":{"get":{"operationId":"getSummaryReport","tags":["Raporlar"],"summary":"Görüşme, dakika ve randevu özeti","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/webhooks":{"get":{"operationId":"listWebhooks","tags":["Webhook’lar"],"summary":"Webhook’lar, olay kataloğu ve teslimat kuralları","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"post":{"operationId":"createWebhook","tags":["Webhook’lar"],"summary":"Webhook ekler; yanıtta secret bir kez görünür","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Aynı anahtarla gelen tekrar istek işlenmez; ilk yanıt döner (24 saat)"}],"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{}}}},"400":{"$ref":"#/components/responses/Error","description":"Geçersiz adres ya da olay"},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"409":{"$ref":"#/components/responses/Error","description":"En fazla 10 webhook"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":500},"events":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"description":{"default":"","type":"string","maxLength":200},"active":{"default":true,"type":"boolean"},"includeTranscript":{"default":true,"type":"boolean"}},"required":["url"]}}}}}},"/webhooks/{id}":{"get":{"operationId":"getWebhook","tags":["Webhook’lar"],"summary":"Tek webhook","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Webhook yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}},"patch":{"operationId":"updateWebhook","tags":["Webhook’lar"],"summary":"url, description, events, active, includeTranscript günceller","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Webhook yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":500},"events":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"description":{"default":"","type":"string","maxLength":200},"active":{"default":true,"type":"boolean"},"includeTranscript":{"default":true,"type":"boolean"}}}}}}},"delete":{"operationId":"deleteWebhook","tags":["Webhook’lar"],"summary":"Webhook’u ve teslimat geçmişini siler","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Webhook yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/webhooks/{id}/test":{"post":{"operationId":"testWebhook","tags":["Webhook’lar"],"summary":"Örnek olay gönderir, sonucu hemen döner","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Webhook yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"eventType":{"type":"string","minLength":1,"maxLength":60}}}}}}}},"/webhooks/{id}/rotate-secret":{"post":{"operationId":"rotateWebhookSecret","tags":["Webhook’lar"],"summary":"İmza anahtarını yeniler (geçiş süresiyle)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Webhook yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"graceHours":{"default":24,"type":"integer","minimum":0,"maximum":168}}}}}}}},"/webhooks/{id}/deliveries":{"get":{"operationId":"listWebhookDeliveries","tags":["Webhook’lar"],"summary":"Teslimat geçmişi","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","success","failed","retrying","delivered"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"before","in":"query","required":false,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Webhook yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/webhook-deliveries/{id}/retry":{"post":{"operationId":"retryWebhookDelivery","tags":["Webhook’lar"],"summary":"Teslimatı hemen yeniden dener","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Teslimat yok"},"409":{"$ref":"#/components/responses/Error","description":"Zaten teslim edilmiş"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/webhook-events":{"get":{"operationId":"listWebhookEvents","tags":["Webhook’lar"],"summary":"Olay geçmişi (son 7 gün)","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","maxLength":60}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"before","in":"query","required":false,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/webhook-events/{id}":{"get":{"operationId":"getWebhookEvent","tags":["Webhook’lar"],"summary":"Tek olay (gönderilen zarfın aynısı)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Olay yok"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}}}},"/webhook-events/{id}/resend":{"post":{"operationId":"resendWebhookEvent","tags":["Webhook’lar"],"summary":"Olayı seçilen webhook’a yeniden gönderir","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Kayıt kimliği"}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Error","description":"Anahtar geçersiz ya da iptal edilmiş"},"403":{"$ref":"#/components/responses/Error","description":"Geliştirici ayarları kapalı ya da giden arama onaylı değil"},"404":{"$ref":"#/components/responses/Error","description":"Olay ya da webhook yok"},"409":{"$ref":"#/components/responses/Error","description":"Zaten teslim edilmiş"},"429":{"$ref":"#/components/responses/Error","description":"Dakikada 120 istek aşıldı; Retry-After kadar bekle"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"webhookId":{"type":"string","pattern":"^[a-f\\d]{24}$"}},"required":["webhookId"]}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"bgl_…","description":"Authorization: Bearer bgl_… (X-API-Key da kabul edilir)"}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Türkçe, kullanıcıya gösterilebilir hata cümlesi"},"code":{"type":"string"},"details":{}}}},"responses":{"Error":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}