AgentFixAPI Referencev1.0 (REST)

Google Developer Standartlarında REST API

AgentFix API Referansı

AgentFix REST API, yapay zeka destekli sesli çağrılarınızı, hasta kayıtlarınızı, randevu takvimlerinizi ve tekliflerinizi harici sistemleriniz, CRM ve mobil uygulamalarınızla sorunsuz entegre etmenizi sağlar. Tüm istekler HTTPS üzerinden JSON formatında kabul edilir.

Canlı Base URL

https://agentfix.com.tr

Bearer Kimlik Doğrulama

Her istek için benzersiz ve güvenli API anahtarı veya JWT belirteci.

Standart JSON Şeması

Öngörülebilir yanıt yapıları, standart pagination ve ayrıntılı hata gövdeleri.

Yüksek Hız & Düşük Gecikme

Optimize edilmiş veritabanı sorguları ve ortalama 50ms yanıt süreleri.

Kimlik Doğrulama (Authentication)

AgentFix API'sine yapılan tüm isteklerin HTTP Authorization başlığında geçerli bir Bearer anahtarı içermesi zorunludur.

Header Formatı

Authorization: Bearer <AGENTFIX_API_TOKEN>

Anahtarınızı asla tarayıcı istemci kodunda açıkta bırakmayın.
Sadece TLS 1.3/HTTPS şifreli bağlantılar üzerinden istek yapın.

cURL Başlık Örneği

curl -X GET "https://agentfix.com.tr/api/customers" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Endpoint Referansı

Tüm metotlar, parametre şemaları, örnek istekler ve JSON yanıtları.

Toplam 19 Endpoint

Hastalar

Hasta kayıtlarını listeleyin, filtreleyin, yeni hasta ekleyin veya durumlarını dönüştürün.

GET/api/customers

Hastaları Listele

Hesabınıza ait tüm hasta kayıtlarını sayfalı (paginated) ve filtrelenebilir olarak döndürür.

Sorgu Parametreleri (Query Parameters)

Parametre	Tür	Açıklama
pageopsiyonel Varsayılan: 1	integer	Görüntülenecek sayfa numarası.
per_pageopsiyonel Varsayılan: 25	integer	Sayfa başına düşen hasta sayısı (Maks: 100).
searchopsiyonel	string	İsim, e-posta veya telefon ile eşleşen hastaları arar.
statusopsiyonel	string	Filtrelenecek durum: "potential", "customer", "archived".

Döndürülen Yanıt Kodları

200 OKHasta listesi ve sayfalama üst verisi başarıyla döndü.

401 UnauthorizedYetkisiz erişim. API anahtarı geçersiz veya eksik.

CURL

curl -X GET "https://agentfix.com.tr/api/customers" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

{
  "success": true,
  "data": [
    {
      "id": 42,
      "name": "Ayşe Yılmaz",
      "email": "ayse@example.com",
      "phone": "+905551112233",
      "status": "customer",
      "company": "Yılmaz Teknoloji",
      "created_at": "2026-08-01T10:00:00Z"
    },
    {
      "id": 43,
      "name": "Mehmet Kaya",
      "email": "mehmet@example.com",
      "phone": "+905552223344",
      "status": "potential",
      "company": "Kaya Mimarlık",
      "created_at": "2026-08-05T14:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 2,
    "last_page": 1
  }
}

GET/api/customers/:id

Hasta Detayı Getir

Belirtilen ID numarasına sahip tek bir hastanın tüm detay kayıtlarını getirir.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Getirilecek hastanın benzersiz kimlik numarası (örn: 42).

Döndürülen Yanıt Kodları

200 OKHasta detayı başarıyla bulundu.

404 Not FoundBelirtilen ID ile eşleşen hasta bulunamadı.

CURL

curl -X GET "https://agentfix.com.tr/api/customers/42" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

{
  "id": 42,
  "name": "Ayşe Yılmaz",
  "email": "ayse@example.com",
  "phone": "+905551112233",
  "status": "customer",
  "company": "Yılmaz Teknoloji",
  "notes": "VIP Hasta, 2026 yılı kurumsal paket anlaşması var.",
  "created_at": "2026-08-01T10:00:00Z",
  "updated_at": "2026-08-10T12:00:00Z"
}

POST/api/customers

Yeni Hasta Oluştur

Sisteme yeni bir hasta veya potansiyel hasta (lead) kaydı ekler.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
name*zorunlu	string	Hastanın tam adı veya şirket unvanı.
emailopsiyonel	string	Geçerli bir e-posta adresi.
phoneopsiyonel	string	E.164 uluslararası formatında telefon numarası (örn: +905551112233).
companyopsiyonel	string	Hasta firma unvanı.
statusopsiyonel	string	"potential" veya "customer".
notesopsiyonel	string	Hasta ile ilgili başlangıç notları.

Döndürülen Yanıt Kodları

201 CreatedHasta kaydı başarıyla oluşturuldu.

422 Unprocessable EntityDoğrulama hatası (örn: ad alanı eksik veya e-posta biçimi geçersiz).

CURL

curl -X POST "https://agentfix.com.tr/api/customers" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "name": "Ayşe Yılmaz",  "email": "ayse@example.com",  "phone": "+905551112233",  "company": "Yılmaz Teknoloji",  "status": "potential",  "notes": "Web formundan gelen lead."}'

Örnek Yanıt (201 Created)

{
  "id": 42,
  "name": "Ayşe Yılmaz",
  "email": "ayse@example.com",
  "phone": "+905551112233",
  "status": "potential",
  "created_at": "2026-08-15T05:00:00Z"
}

PUT/api/customers/:id

Hasta Bilgilerini Güncelle

Var olan hastanın iletişim veya profil bilgilerini günceller.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Güncellenecek hastanın ID numarası.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
nameopsiyonel	string	Güncellenecek ad.
emailopsiyonel	string	Güncellenecek e-posta.
phoneopsiyonel	string	Güncellenecek telefon.
statusopsiyonel	string	"potential" veya "customer".
notesopsiyonel	string	Güncel notlar.

Döndürülen Yanıt Kodları

200 OKHasta başarıyla güncellendi.

CURL

curl -X PUT "https://agentfix.com.tr/api/customers/42" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "name": "Ayşe Yılmaz",  "status": "customer",  "notes": "Hasta sözleşmesi imzalandı."}'

Örnek Yanıt (200 OK)

{
  "id": 42,
  "name": "Ayşe Yılmaz",
  "email": "ayse@example.com",
  "status": "customer",
  "updated_at": "2026-08-15T05:10:00Z"
}

DELETE/api/customers/:id

Hastayı Sil

Hasta kaydını kalıcı olarak veya arşivleme politikası uyarınca siler.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Silinecek hastanın ID numarası.

Döndürülen Yanıt Kodları

204 No ContentKayıt başarıyla silindi, gövde boş döndü.

CURL

curl -X DELETE "https://agentfix.com.tr/api/customers/42" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (204 No Content)

// 204 No Content (Gövde Yok)

POST/api/customers/:id/convert

Hastaya Dönüştür (Convert)

"potential" durumundaki bir adayı doğrudan resmi "customer" durumuna çevirir.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Dönüştürülecek hastanın ID numarası.

Döndürülen Yanıt Kodları

200 OKAday başarıyla hastaya dönüştürüldü.

CURL

curl -X POST "https://agentfix.com.tr/api/customers/42/convert" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

{
  "success": true,
  "message": "Aday başarıyla hastaya dönüştürüldü.",
  "customer": {
    "id": 42,
    "name": "Ayşe Yılmaz",
    "status": "customer",
    "converted_at": "2026-08-15T05:15:00Z"
  }
}

GET/api/customers/search

Hasta Arama

Ad, e-posta veya telefon numarası içinde hızlı arama yaparak eşleşen hastaları dizi olarak getirir.

Sorgu Parametreleri (Query Parameters)

Parametre	Tür	Açıklama
q*zorunlu	string	Aranacak kelime veya telefon parçası (örn: "Ayşe").
limitopsiyonel Varsayılan: 10	integer	Döndürülecek maksimum sonuç.

Döndürülen Yanıt Kodları

200 OKEşleşen hasta listesi.

CURL

curl -X GET "https://agentfix.com.tr/api/customers/search" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

[
  {
    "id": 42,
    "name": "Ayşe Yılmaz",
    "email": "ayse@example.com",
    "phone": "+905551112233",
    "status": "customer"
  }
]

Çağrılar

Yapay zeka sesli asistan veya santral çağrı kayıtlarını, sürelerini ve metriklerini yönetin.

GET/api/calls

Çağrıları Listele

Gelen ve giden tüm sesli çağrı kayıtlarını filtrelenmiş ve sayfalanmış olarak listeler.

Sorgu Parametreleri (Query Parameters)

Parametre	Tür	Açıklama
statusopsiyonel	string	Çağrı durumu: "completed", "pending", "failed", "busy".
customer_idopsiyonel	integer	Belirli bir hastaya ait çağrıları filtreler.
pageopsiyonel Varsayılan: 1	integer	Sayfa numarası.
per_pageopsiyonel Varsayılan: 20	integer	Sayfa başına çağrı sayısı.

Döndürülen Yanıt Kodları

200 OKÇağrı kayıtları listelendi.

CURL

curl -X GET "https://agentfix.com.tr/api/calls" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

{
  "success": true,
  "data": [
    {
      "id": 91,
      "customer_id": 42,
      "customer_name": "Ayşe Yılmaz",
      "customer_phone": "+905551112233",
      "status": "completed",
      "direction": "inbound",
      "duration": 142,
      "cost": "0.45",
      "started_at": "2026-08-14T18:20:00Z",
      "ended_at": "2026-08-14T18:22:22Z",
      "recording_url": "https://agentfix.com.tr/recordings/call-91.mp3"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 1
  }
}

POST/api/calls

Yeni Çağrı İsteği Başlat

Belirtilen telefon numarasına AI asistanı üzerinden bekleyen (pending) bir dış arama planlar.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
customer_idopsiyonel	integer	Bağlı hasta ID (opsiyonel).
phone_number*zorunlu	string	Aranacak telefon numarası (+90 formatında).
notesopsiyonel	string	Arama öncesi asistan promptuna eklenecek not/amaç.
assistant_idopsiyonel	string	Kullanılacak özel AI asistan kimliği.

Döndürülen Yanıt Kodları

201 CreatedÇağrı isteği kuyruğa alındı.

CURL

curl -X POST "https://agentfix.com.tr/api/calls" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "customer_id": 42,  "phone_number": "+905551112233",  "notes": "Hastaya teklif onay hatırlatması yapılacak."}'

Örnek Yanıt (201 Created)

{
  "success": true,
  "call": {
    "id": 92,
    "customer_id": 42,
    "phone_number": "+905551112233",
    "status": "pending",
    "created_at": "2026-08-15T05:20:00Z"
  }
}

GET/api/calls/:id

Çağrı Detayı ve Transkript

Çağrının süre, durum, ses kaydı ve yapay zeka transkript detaylarını getirir.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Çağrının ID numarası.

Döndürülen Yanıt Kodları

200 OKÇağrı ve transkript ayrıntıları getirildi.

CURL

curl -X GET "https://agentfix.com.tr/api/calls/42" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

{
  "id": 91,
  "customer_id": 42,
  "status": "completed",
  "duration": 142,
  "transcript": "Agent: Merhaba, AgentFix destek hattına hoş geldiniz. Nasıl yardımcı olabilirim?...",
  "sentiment": "positive",
  "summary": "Hasta haftaya salı günü randevu almak istediğini belirtti."
}

PUT/api/calls/:id

Çağrı Notu Güncelle

Görüşme sonrasında çağrı kaydına yönetici veya temsilci notu ekler.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Çağrının ID numarası.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
notes*zorunlu	string	Eklenmek veya güncellenmek istenen not.

Döndürülen Yanıt Kodları

200 OKÇağrı notu başarıyla güncellendi.

CURL

curl -X PUT "https://agentfix.com.tr/api/calls/42" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "notes": "Hasta ile tekrar görüşüldü, randevu saati 14:00 olarak teyit edildi."}'

Örnek Yanıt (200 OK)

{
  "id": 91,
  "notes": "Hasta ile tekrar görüşüldü, randevu saati 14:00 olarak teyit edildi."
}

DELETE/api/calls/:id

Çağrı Kaydını Sil

Çağrı kaydını soft-delete yöntemiyle arşivler.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Çağrının ID numarası.

Döndürülen Yanıt Kodları

204 No ContentÇağrı kaydı silindi.

CURL

curl -X DELETE "https://agentfix.com.tr/api/calls/42" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (204 No Content)

// 204 No Content

Randevular

Hastalarla planlanan takvim randevularını yönetin, durumlarını teyit edin veya güncelleyin.

GET/api/appointments

Randevuları Listele

Tüm randevu kayıtlarını tarih ve durum filtresine göre listeler.

Sorgu Parametreleri (Query Parameters)

Parametre	Tür	Açıklama
statusopsiyonel	string	"scheduled", "confirmed", "completed", "cancelled", "no_show".
from_dateopsiyonel	string	ISO 8601 başlangıç tarihi (örn: 2026-08-01).
to_dateopsiyonel	string	ISO 8601 bitiş tarihi.

Döndürülen Yanıt Kodları

200 OKRandevular listelendi.

CURL

curl -X GET "https://agentfix.com.tr/api/appointments" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

[
  {
    "id": 12,
    "customer_id": 42,
    "customer_name": "Ayşe Yılmaz",
    "title": "Yıllık Bakım ve Entegrasyon Kontrolü",
    "scheduled_at": "2026-08-20T10:00:00.000Z",
    "status": "scheduled",
    "location": "Online / Google Meet",
    "notes": "Sistem logları gözden geçirilecek."
  }
]

GET/api/appointments/upcoming

Yaklaşan Randevuları Getir

Şu andan ileriye dönük "scheduled" veya "confirmed" durumdaki ilk randevuları kronolojik sıralı döndürür.

Sorgu Parametreleri (Query Parameters)

Parametre	Tür	Açıklama
limitopsiyonel Varsayılan: 10	integer	Getirilecek maksimum randevu adedi.

Döndürülen Yanıt Kodları

200 OKYaklaşan randevular getirildi.

CURL

curl -X GET "https://agentfix.com.tr/api/appointments/upcoming" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

[
  {
    "id": 12,
    "customer_id": 42,
    "title": "Yıllık Bakım ve Entegrasyon Kontrolü",
    "scheduled_at": "2026-08-20T10:00:00.000Z",
    "status": "scheduled"
  }
]

POST/api/appointments

Yeni Randevu Oluştur

Bir hasta için takvimde yeni bir randevu slotu rezerve eder.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
customer_id*zorunlu	integer	Randevunun atanacağı hasta ID.
title*zorunlu	string	Randevu konusu / başlığı.
scheduled_at*zorunlu	string	ISO 8601 formatında randevu tarihi ve saati (UTC).
locationopsiyonel	string	Toplantı yeri veya video bağlantı linki.
notesopsiyonel	string	Randevu ile ilgili özel açıklamalar.

Döndürülen Yanıt Kodları

201 CreatedRandevu başarıyla oluşturuldu.

CURL

curl -X POST "https://agentfix.com.tr/api/appointments" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "customer_id": 42,  "title": "Yıllık Bakım ve Entegrasyon Kontrolü",  "scheduled_at": "2026-08-20T10:00:00.000Z",  "location": "Online Google Meet",  "notes": "Hasta ekibi ile teknik gözden geçirme."}'

Örnek Yanıt (201 Created)

{
  "id": 12,
  "customer_id": 42,
  "title": "Yıllık Bakım ve Entegrasyon Kontrolü",
  "scheduled_at": "2026-08-20T10:00:00.000Z",
  "status": "scheduled",
  "created_at": "2026-08-15T05:22:00Z"
}

PUT/api/appointments/:id

Randevuyu Güncelle

Randevunun başlık, tarih/saat, konum ve durum bilgilerini revize eder.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Randevu ID numarası.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
titleopsiyonel	string	Yeni başlık.
scheduled_atopsiyonel	string	Yeni tarih ve saat.
statusopsiyonel	string	Yeni durum: scheduled, confirmed, completed, cancelled.
notesopsiyonel	string	Güncel notlar.

Döndürülen Yanıt Kodları

200 OKRandevu güncellendi.

CURL

curl -X PUT "https://agentfix.com.tr/api/appointments/42" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "title": "Yıllık Bakım ve Entegrasyon Kontrolü",  "scheduled_at": "2026-08-20T11:00:00.000Z",  "status": "confirmed"}'

Örnek Yanıt (200 OK)

{
  "id": 12,
  "title": "Yıllık Bakım ve Entegrasyon Kontrolü",
  "scheduled_at": "2026-08-20T11:00:00.000Z",
  "status": "confirmed"
}

PATCH/api/appointments/:id/status

Randevu Durumunu Hızlı Değiştir

Yalnızca randevu durumunu güncellemek için kullanılan hafif (lightweight) endpoint.

Yol Parametreleri (Path Parameters)

Parametre	Tür	Açıklama
id*zorunlu	integer	Randevu ID numarası.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
status*zorunlu	string	"scheduled", "confirmed", "completed", "cancelled", "no_show".

Döndürülen Yanıt Kodları

200 OKRandevu durumu güncellendi.

CURL

curl -X PATCH "https://agentfix.com.tr/api/appointments/42/status" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "status": "completed"}'

Örnek Yanıt (200 OK)

{
  "id": 12,
  "status": "completed",
  "updated_at": "2026-08-20T12:00:00Z"
}

Teklifler

Hastalara sunulan fiyat ve hizmet tekliflerini oluşturun ve durumlarını takip edin.

GET/api/offers

Teklifleri Listele

Tüm teklifleri sayfalı olarak döndürür. Duruma ve hastaya göre filtrelenebilir.

Sorgu Parametreleri (Query Parameters)

Parametre	Tür	Açıklama
statusopsiyonel	string	"draft", "pending", "sent", "accepted", "rejected", "expired".
customer_idopsiyonel	integer	Belirli bir hastaya ait teklifler.
pageopsiyonel Varsayılan: 1	integer	Sayfa no.
per_pageopsiyonel Varsayılan: 25	integer	Sayfa boyutu.

Döndürülen Yanıt Kodları

200 OKTeklifler başarıyla listelendi.

CURL

curl -X GET "https://agentfix.com.tr/api/offers" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json"

Örnek Yanıt (200 OK)

{
  "success": true,
  "data": [
    {
      "id": 33,
      "customer_id": 42,
      "customer_name": "Ayşe Yılmaz",
      "title": "AgentFix AI Kurumsal Yıllık Paket",
      "amount": "12500.00",
      "currency": "TRY",
      "status": "draft",
      "valid_until": "2026-09-15",
      "created_at": "2026-08-14T09:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 1,
    "last_page": 1
  }
}

POST/api/offers

Yeni Teklif Oluştur

Hasta için yeni bir taslak (draft) veya gönderime hazır teklif kaydı oluşturur.

İstek Gövdesi (Request Body - JSON)

Alan	Tür	Açıklama
customer_id*zorunlu	integer	Teklifin iletileceği hasta ID.
title*zorunlu	string	Teklif başlığı / konusu.
amount*zorunlu	number	Teklif toplam bedeli.
currencyopsiyonel	string	Para birimi ("TRY", "USD", "EUR").
statusopsiyonel	string	"draft", "pending", "sent", "accepted", "rejected".
notesopsiyonel	string	Kapsam, indirim ve şart notları.
valid_untilopsiyonel	string	Teklif geçerlilik son tarihi (YYYY-MM-DD).

Döndürülen Yanıt Kodları

201 CreatedTeklif başarıyla oluşturuldu.

CURL

curl -X POST "https://agentfix.com.tr/api/offers" \
  -H "Authorization: Bearer $AGENTFIX_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{  "customer_id": 42,  "title": "AgentFix AI Kurumsal Yıllık Paket",  "amount": 12500,  "currency": "TRY",  "status": "draft",  "notes": "7/24 AI çağrı karşılama ve WhatsApp entegrasyonu dahildir.",  "valid_until": "2026-09-15"}'

Örnek Yanıt (201 Created)

{
  "id": 33,
  "customer_id": 42,
  "title": "AgentFix AI Kurumsal Yıllık Paket",
  "amount": "12500.00",
  "total": "12500.00",
  "currency": "TRY",
  "status": "draft",
  "created_at": "2026-08-15T05:25:00Z"
}

Hata Kodları ve Sözleşmesi

AgentFix API, standart HTTP durum kodlarını kullanır. 4xx serisi hatalar istemci kaynaklı sorunları, 5xx serisi sunucu taraflı istisnaları temsil eder. Hatalı yanıtlarda mutlaka açıklayıcı bir JSON hata nesnesi döndürülür.

// Standart Hata Yanıt Şeması

{
  "error": "Unprocessable Entity",
  "message": "İstek gövdesi doğrulama kurallarına uymuyor.",
  "statusCode": 422,
  "timestamp": "2026-08-15T05:30:00Z"
}

HTTP Kodu	Kategori	Açıklama & Çözüm Önerisi
200 OK	Başarılı	İstek başarıyla işlendi ve veri döndürüldü.
201 Created	Oluşturuldu	Yeni kayıt (hasta, çağrı, randevu, teklif) başarıyla oluşturuldu.
204 No Content	İçerik Yok	İşlem (örneğin silme) başarılı oldu, yanıt gövdesi boştur.
400 Bad Request	İstemci Hatası	İstek biçimi, URL parametresi veya JSON gövdesi sözdizimsel olarak geçersiz.
401 Unauthorized	Yetkilendirme Hatası	Authorization başlığı eksik, Bearer API anahtarı geçersiz veya süresi dolmuş.
403 Forbidden	Erişim Engellendi	Kimlik doğrulandı ancak erişilmek istenen kaynak hesabınıza ait değil veya yetkiniz yetersiz.
404 Not Found	Bulunamadı	İstenen kaynak veya ID numarası sistemde bulunamadı.
422 Unprocessable	Doğrulama Hatası	İstek JSON formatında geçerli ancak zorunlu alanlar eksik veya veri tipi hatalı.
429 Too Many Requests	Hız Sınırı	Dakikalık veya günlük API istek kotası aşıldı (Rate limit).
500 Server Error	Sunucu Hatası	Sunucu tarafında beklenmeyen bir dahili durum oluştu.