Native iPhone Uygulaması

Belge çekin, OCR tarayın, tahsilat ve randevu hatırlatmalarını anında push olarak yönetin.

OttoOS iOS uygulaması saha ekipleri için kamera, belge, bildirim ve hızlı operasyon akışlarını web panelden daha hızlı hale getirir.

Kamera ile belge toplamaPush ve uygulama içi hatırlatmalarWebden uygulamaya tek dokunuş geçiş
Uygulamayı AçWebden Telefona GönderApp Store bağlantısı yayın sonrası aktifleşir

API Belgeleri

API'ye Genel Bakış

OttoOS REST API ile platformumuzu kendi uygulamalarınıza ve iş akışlarınıza entegre edebilirsiniz. API erişimi PRO ve üzeri paketlerde kullanılabilir.

Temel Bilgiler

  • Base URL: https://ottoos.com.tr/api/v1
  • Protokol: HTTPS (zorunlu)
  • Format: Tüm istek ve yanıtlar JSON formatındadır
  • Encoding: UTF-8
  • Rate Limit: Dakikada 1.000 istek (PRO), 5.000 istek (Enterprise)

Kimlik Doğrulama

API isteklerinizde Authorization header'ı ile Bearer token kullanmanız gerekmektedir:

Authorization: Bearer YOUR_API_KEY

API anahtarınızı Ayarlar → API Yönetimi bölümünden oluşturabilirsiniz. Anahtarlarınızı güvenli bir şekilde saklayın ve asla istemci tarafı kodunda (frontend) kullanmayın.

Temel Endpoint'ler

Mülkler (Properties)

  • GET /v1/properties — Mülk listesi (sayfalama, filtreleme destekli)
  • GET /v1/properties/:id — Tek mülk detayı
  • POST /v1/properties — Yeni mülk oluştur
  • PUT /v1/properties/:id — Mülk güncelle

Müşteriler (Customers)

  • GET /v1/customers — Müşteri listesi
  • GET /v1/customers/:id — Müşteri detayı
  • POST /v1/customers — Yeni müşteri ekle

Projeler (Projects)

  • GET /v1/projects — Proje listesi
  • GET /v1/projects/:id — Proje detayı ve birimleri

Satışlar (Sales)

  • GET /v1/sales — Satış listesi
  • POST /v1/sales — Yeni satış kaydı

Raporlar (Reports)

  • GET /v1/reports/summary — Genel özet rapor
  • GET /v1/cashflow — Nakit akış raporu

Sayfalama

Liste endpoint'leri sayfalama destekler:

  • ?page=1&limit=20 — Sayfa numarası ve sayfa başına kayıt
  • ?sort=createdAt&order=desc — Sıralama
  • ?search=keyword — Arama

Hata Kodları

  • 200 — Başarılı
  • 201 — Kaynak oluşturuldu
  • 400 — Geçersiz istek (eksik/hatalı parametre)
  • 401 — Kimlik doğrulama hatası (geçersiz API anahtarı)
  • 403 — Yetki hatası (bu kaynağa erişim izniniz yok)
  • 404 — Kaynak bulunamadı
  • 429 — Rate limit aşıldı
  • 500 — Sunucu hatası

Webhook Desteği

Belirli olaylarda (yeni satış, ödeme alındı, sözleşme imzalandı vb.) otomatik bildirim almak için webhook URL'nizi Ayarlar → API bölümünden tanımlayabilirsiniz.

SDK ve Kütüphaneler

JavaScript/TypeScript ve Python SDK'larımız geliştirme aşamasındadır. Güncellemeler için bu sayfayı takip edin.

API Desteği

API entegrasyonu hakkında teknik sorularınız için api@ottoos.com.tr adresine yazabilirsiniz. Yanıt süresi: iş günlerinde en geç 24 saat.