bozfix

BOZFIX'teki aktif hizmet kategorilerini (elektrikçi, tesisatçı, klima, boya...) listeler. Usta aramadan veya talep açmadan önce doğru kategori id'sini bulmak için kullan.

{
  "type": "object",
  "properties": {},
  "required": []
}

Antalya'da ONAYLI ustaları puan ve güven skoruna göre listeler. ilce ve kategori_id (kategoriler ucundan) ile daraltılabilir. Kişisel iletişim bilgisi döndürmez — herkese açık profil linki verir.

{
  "type": "object",
  "properties": {
    "ilce": {
      "type": "string",
      "description": "Antalya ilçesi, örn. Muratpaşa"
    },
    "kategori_id": {
      "type": "integer",
      "description": "kategoriler ucundan alınan kategori id"
    },
    "limit": {
      "type": "integer",
      "description": "En fazla kaç usta (1-50, varsayılan 10)"
    }
  },
  "required": []
}

Bir kategori/ilçe için, tamamlanmış GERÇEK işlere dayalı tahmini fiyat aralığını (TRY) döner. Yeterli veri yoksa bunu açıkça belirtir — uydurma fiyat verilmez.

{
  "type": "object",
  "properties": {
    "kategori_id": {
      "type": "integer",
      "description": "kategoriler ucundan alınan kategori id"
    },
    "ilce": {
      "type": "string",
      "description": "Antalya ilçesi (opsiyonel)"
    }
  },
  "required": [
    "kategori_id"
  ]
}

Kullanıcı adına BOZFIX'te hizmet talebi açar. ⚠️ Talep ONAY BEKLER: kayıt oluşur ama USTALARA GİTMEZ — kullanıcı verdiğimiz ONAY LİNKİNE tıklayıp açıklamayı görüp ONAYLAYINCA ustalar haberdar olur ve teklif verir. Kullanıcı onaylamazsa hiçbir ustaya gitmez (sahte/yanlış talepte usta boşa yola çıkmasın diye insan onayı ŞART). ad_soyad, telefon ve ilce ZORUNLUDUR. Yanıttaki onay_linki'ni kullanıcıya ver. BOZFIX komisyon/ücret almaz.

{
  "type": "object",
  "properties": {
    "ad_soyad": {
      "type": "string",
      "description": "Müşterinin adı soyadı"
    },
    "telefon": {
      "type": "string",
      "description": "Ustaların arayacağı telefon numarası"
    },
    "ilce": {
      "type": "string",
      "description": "Antalya ilçesi, örn. Kepez"
    },
    "kategori_id": {
      "type": "integer",
      "description": "Hizmet kategorisi id (kategoriler ucundan)"
    },
    "aciklama": {
      "type": "string",
      "description": "İşin kısa açıklaması"
    },
    "oncelik": {
      "type": "string",
      "enum": [
        "normal",
        "acil"
      ],
      "description": "Aciliyet (varsayılan normal)"
    }
  },
  "required": [
    "ad_soyad",
    "telefon",
    "ilce"
  ]
}

Kullanıcının anlattığı soruna göre bir talep TASLAĞI hazırlar ve KISA LİNK (/t/{kod}) döner. LİNK TALEP AÇMAZ — kullanıcı linke tıklayıp formu görüp DÜZENLEYİP ONAYLAYINCA talep açılır. ad_soyad/telefon GEREKMEZ ve gönderilMEMELİ (kullanıcı kendi girer, KVKK). kategori_id gerçek+aktif olmalı (kategoriler ucundan); belirsizse boş bırak, kullanıcı formda tamamlar. talep_olustur'a göre DAHA GÜVENLİ: sahte/uydurma taslak kayıt yaratmaz, insan onayı şarttır.

{
  "type": "object",
  "properties": {
    "kategori_id": {
      "type": "integer",
      "description": "Hizmet kategorisi id (kategoriler ucundan; v1 elektrik)"
    },
    "ilce": {
      "type": "string",
      "description": "Antalya ilçesi, örn. Kepez"
    },
    "aciklama": {
      "type": "string",
      "description": "Sorunun kısa açıklaması (kullanıcının anlattığı)"
    },
    "oncelik": {
      "type": "string",
      "enum": [
        "normal",
        "acil"
      ],
      "description": "Aciliyet (varsayılan normal)"
    }
  },
  "required": [
    "aciklama"
  ]
}

Daha önce açılmış bir talebin durumunu ve gelen teklif özetini (kaç teklif, fiyat aralığı) döner. GİZLİLİK: yalnız talep_no VE talebi açan telefon birlikte doğru verilirse yanıt döner (başkasının talebi görülemez). Yeni açtığın talebin ustalardan teklif alıp almadığını kontrol etmek için kullan.

{
  "type": "object",
  "properties": {
    "talep_no": {
      "type": "integer",
      "description": "talep_olustur'un döndüğü talep numarası"
    },
    "telefon": {
      "type": "string",
      "description": "Talebi açarken verilen telefon (doğrulama için)"
    }
  },
  "required": [
    "talep_no",
    "telefon"
  ]
}

Bir Antalya ilçesinde (opsiyonel kategori ile) BOZFIX'te kaç ONAYLI usta hizmet verdiğini DÜRÜSTÇE söyler: iyi kapsama / zayıf / henüz yok. Kullanıcıya boş vaat vermeden önce beklentiyi doğru kur. Kapsama zayıfsa talebi yine de açabilirsin ama bunu belirt.

{
  "type": "object",
  "properties": {
    "ilce": {
      "type": "string",
      "description": "Antalya ilçesi, örn. Kepez"
    },
    "kategori_id": {
      "type": "integer",
      "description": "Hizmet kategorisi id (opsiyonel; kategoriler ucundan)"
    }
  },
  "required": [
    "ilce"
  ]
}

Bir ONAYLI ustanın belirli bir GÜNDE dolu olduğu (randevu/meşgul) saatleri döner — ajan kullanıcıya "şu saatler dolu, diğerleri uygun olabilir" diyebilir. Kişisel/müşteri bilgisi DÖNDÜRMEZ (yalnız dolu saatler). Kesin randevu için talep_olustur ile talep açılır; usta müşteriyi arar. usta (profil slug) ve tarih (YYYY-AA-GG) gerekir.

{
  "type": "object",
  "properties": {
    "usta": {
      "type": "string",
      "description": "Usta profil slug (usta_ara ucundaki profil linkinin son parçası)"
    },
    "tarih": {
      "type": "string",
      "description": "Gün, YYYY-AA-GG (örn. 2026-07-20)"
    }
  },
  "required": [
    "usta",
    "tarih"
  ]
}