🐾 PettyGo API

Pet Taşıma ve Teslimat Hizmetleri API Dokümantasyonu

v1.0.0

📚 API Hakkında

PettyGo API, pet taşıma ve teslimat hizmetleri için geliştirilmiş RESTful bir API'dir. Tüm endpoint'ler güvenli API Key kontrolü ile korunmaktadır. API, müşteriler, sürücüler ve gelecekte veteriner, pet kuaför, pet shop gibi iş ortakları için tasarlanmıştır.

🔒 Güvenlik

Önemli: Tüm protected endpoint'ler için X-API-Key header'ında geçerli bir API anahtarı göndermelisiniz. API anahtarı olmadan bu endpoint'lere erişim reddedilir.

🔐 Kimlik Doğrulama

POST /api/v1/auth/login

Kullanıcı girişi yapar ve JWT token döndürür.

🔓 Public
POST /api/v1/auth/register

Yeni kullanıcı kaydı oluşturur (müşteri veya sürücü).

🔓 Public
POST /api/v1/auth/logout

Kullanıcı çıkışı yapar, token'ı geçersiz kılar.

🔓 Public

👤 Kullanıcı Profili

GET /api/v1/user-profile

Kullanıcı profil bilgilerini getirir.

🔒 API Key Gerekli
POST /api/v1/update-profile

Kullanıcı profil bilgilerini günceller.

🔒 API Key Gerekli
POST /api/v1/change-password

Kullanıcı şifresini değiştirir.

🔒 API Key Gerekli

🐕 Pet Yönetimi

GET /api/v1/pets

Kullanıcıya ait tüm petleri listeler.

🔒 API Key Gerekli
GET /api/v1/pet-types

Mevcut pet türlerini listeler (Köpek, Kedi, Kuş, vb.).

🔒 API Key Gerekli
POST /api/v1/pets/create

Yeni pet kaydı oluşturur.

🔒 API Key Gerekli
POST /api/v1/pets/update

Mevcut pet bilgilerini günceller.

🔒 API Key Gerekli
DELETE /api/v1/pets/delete

Pet kaydını siler.

🔒 API Key Gerekli

💉 Aşı Takibi

GET /api/v1/pet-vaccinations

Kullanıcıya ait tüm aşı kayıtlarını listeler.

🔒 API Key Gerekli
GET /api/v1/pet-vaccinations/upcoming

Yaklaşan aşıları listeler (7 gün içinde).

🔒 API Key Gerekli
POST /api/v1/pet-vaccinations

Yeni aşı kaydı oluşturur.

🔒 API Key Gerekli
PUT /api/v1/pet-vaccinations/:id

Aşı kaydını günceller.

🔒 API Key Gerekli
DELETE /api/v1/pet-vaccinations/:id

Aşı kaydını siler.

🔒 API Key Gerekli

📦 İş Yönetimi

POST /api/v1/create-job-request

Müşteri tarafından yeni iş talebi oluşturur.

🔒 API Key Gerekli
GET /api/v1/customer-jobs

Müşteri işlerini listeler (aktif ve tamamlanmış).

🔒 API Key Gerekli
GET /api/v1/driver-job-pool

Sürücü iş havuzunu getirir (atanmamış işler).

🔒 API Key Gerekli
GET /api/v1/driver-jobs

Sürücü görevlerini getirir (atanmış işler).

🔒 API Key Gerekli
POST /api/v1/accept-job

Sürücü tarafından işi kabul eder.

🔒 API Key Gerekli
POST /api/v1/job/mark-picked-up

İşin alındığını işaretler (teslim alındı fotoğrafı ile).

🔒 API Key Gerekli
PATCH /api/v1/job/mark-delivered

İşin teslim edildiğini işaretler.

🔒 API Key Gerekli
POST /api/v1/cancel-job

İşi iptal eder.

🔒 API Key Gerekli
GET /api/v1/calculate-price

İş fiyatını hesaplar (mesafe, pet tipi, aciliyet, vb.).

🔒 API Key Gerekli

🚗 Sürücü İşlemleri

GET /api/v1/driver/work-status

Sürücü mesai durumunu getirir (aktif/pasif).

🔒 API Key Gerekli
POST /api/v1/driver/update-work-status

Sürücü mesai durumunu günceller.

🔒 API Key Gerekli
GET /api/v1/driver/score

Sürücü puanını ve performansını getirir.

🔒 API Key Gerekli
GET /api/v1/driver/penalties

Sürücü ceza kayıtlarını listeler.

🔒 API Key Gerekli
PATCH /api/v1/job/update-location

Sürücü konumunu günceller (gerçek zamanlı takip için).

🔒 API Key Gerekli

⭐ Değerlendirme ve Görüşler

POST /api/v1/job-feedback

İş için değerlendirme ve görüş gönderir (müşteri veya sürücü).

🔒 API Key Gerekli
GET /api/v1/customer-reviews

Müşteri için gelen sürücü değerlendirmelerini listeler.

🔒 API Key Gerekli
GET /api/v1/driver-reviews

Sürücü için gelen müşteri değerlendirmelerini listeler.

🔒 API Key Gerekli
GET /api/v1/comments

Hazır yorum şablonlarını getirir (değerlendirme için).

🔒 API Key Gerekli

🔔 Bildirimler ve Duyurular

GET /api/v1/announcements

Aktif duyuruları listeler.

🔒 API Key Gerekli
GET /api/v1/banners

Aktif banner'ları listeler.

🔒 API Key Gerekli
POST /api/v1/notifications/register-token

Push notification token'ı kaydeder.

🔒 API Key Gerekli

✅ Doğrulama

POST /api/v1/verification/send-email-code

E-posta doğrulama kodu gönderir.

🔒 API Key Gerekli
POST /api/v1/verification/send-phone-code

Telefon doğrulama kodu gönderir.

🔒 API Key Gerekli
POST /api/v1/verification/verify-code

Doğrulama kodunu kontrol eder.

🔒 API Key Gerekli

🗺️ Harita ve Konum

GET /api/places/autocomplete

Adres otomatik tamamlama (Google Places API proxy).

🔓 Public
GET /api/places/details

Adres detaylarını getirir (Google Places API proxy).

🔓 Public
GET /api/calculate-distance

İki nokta arası mesafe hesaplar.

🔓 Public
GET /api/route

Rota polyline'ını getirir (harita üzerinde çizim için).

🔓 Public

💬 Destek

GET /api/v1/support/tickets

Destek taleplerini listeler.

🔒 API Key Gerekli
POST /api/v1/support/create-ticket

Yeni destek talebi oluşturur.

🔒 API Key Gerekli

🔌 Partner Entegrasyonları

GET /api/v1/external/job

Dış API için iş havuzu (veteriner, pet kuaför, pet shop gibi partnerler için). Sadece public bilgileri döndürür.

🔒 API Key Gerekli

📝 API Kullanım Örneği

# Örnek: API Key ile istek gönderme curl -X GET "https://api-tls.pettygo.com/api/v1/pets" \ -H "X-API-Key: YOUR_API_KEY_HERE" \ -H "Content-Type: application/json"

🔮 Versiyonlama

API v1.0.0 kullanılıyor. Gelecekte veteriner, pet kuaför, pet shop gibi partner entegrasyonları için v2, v3 gibi yeni versiyonlar eklenebilir. Mevcut endpoint'ler geriye dönük uyumluluk için korunacaktır.