Mobil API
Mobil randevu API: OpenAPI ile native uygulama
Ranovu mobil randevu API'si docs/openapi/public-api.json katalogunda 283 path ile public booking ve provider operasyonlarını belgeler. Bearer JWT auth, Zod şema gate, contract test ve codegen destekli. Native iOS/Android uygulama rollout planı FEATURE_OPENAPI_NATIVE_MOBILE_PLAN ile hizalıdır.
Öne çıkan özellikler
OpenAPI 3.1 katalog
283 path; /api/public/* booking, availability, checkout, services documented.
Bearer auth
Provider API Authorization: Bearer header; cookie fallback web için.
Zod contract gate
npm run docs:openapi + validate:openapi CI'da şema drift engeller.
Rate limit
Public IP limiter; provider global 300/dk Redis bucket.
Native app neden API?
Web /randevu mobil tarayıcıda çalışır; native app push notification ve offline shell ister.
Ranovu API-first tasarım ile mobil istemci aynı backend'i kullanır.
Public booking endpoint'leri
GET /api/public/availability, POST /api/public/appointments, POST /api/public/checkout, GET /api/public/services.
Turnstile ve rate limit mobilde de geçerlidir.
Provider panel API
/api/provider/appointments, settings, services CRUD mobil dashboard için.
panelAuthenticatedFetch web; mobil Bearer token kullanır.
Codegen
npm run codegen:openapi typescript tip üretir. Mobile repo ayrı clone edilebilir.
Contract test
139 integration test assertOpenApiResponseData ile şema parity doğrular.
Breaking change CI'da kırılır.
Kapsam dışı
Webhooks, Inngest, PayTR callback HTML, turnstile-embed OpenAPI'de yok.
ROUTE_COVERAGE.md bilinçli dışlama listesi.
Mobil API'ye başlama
docs/openapi/public-api.json indirin. codegen:openapi çalıştırın.
Public availability probe ile sandbox provider test edin.
Kolay kurulum adımları
Ücretsiz plandan canlı randevu sayfasına - yaklaşık bir saat içinde tamamlanabilir.
Ücretsiz kayıt
Kredi kartı olmadan hesap oluşturun ve panele girin.
Roon AI kurulum
Mesleğinize uygun site metinleri ve bölüm yapısı oluşur.
Hizmetler ve müsaitlik
Fiyat, süre ve haftalık müsaitlik şablonlarını tanımlayın.
Siteyi yayınla
Alt alan adınızda canlı randevu sayfanız açılır.
Randevu linkini paylaş
Instagram, WhatsApp veya mevcut web sitenizde paylaşın.
İlk randevuyu onayla
Panelden onaylayın; WhatsApp onay ve hatırlatmayı test edin.
Scraping web'e kıyasla
HTML scrape kırılgandır. OpenAPI stabil contract sunar.
Versiyon v1.4.x semver dokümante değişikliklerle.
Sık sorulan sorular
- Resmi mobil app var mı?
- Native app plan aşamasında; API production-ready.
- API key?
- Public endpoint'ler API key gerektirmez; rate limit IP bazlı.
- OAuth provider?
- Supabase JWT Bearer; ayrı OAuth2 server yoktur.
- Webhook mobil?
- Provider webhook HMAC imzalı; mobil push ayrı katman.
- Sandbox?
- Staging yobido.com aynı DB; dikkatli test edin.
- GraphQL?
- Yalnızca REST/OpenAPI; GraphQL sunulmaz.
Ranovu ile başlayın
Ücretsiz hesap oluşturun; randevu sitenizi dakikalar içinde yayına alın.