HivePetVetPROFESSIONAL PLATFORM

API Dokümantasyonu
HivePetVet'i Entegre Edin

RESTful API ile HivePetVet'i kendi sisteminize entegre edin ve güçlü özelliklerden yararlanın

REST API Genel Bakış

HivePetVet REST API, HTTP protokolü üzerinden JSON formatında veri alışverişi yapmanıza olanak tanır. Tüm endpoint'ler HTTPS üzerinden güvenli bir şekilde erişilebilir.

Base URL

api.hivepetvet.com

API Version

v1

Format

JSON

Kimlik Doğrulama

API Key

API anahtarınızı dashboard'unuzdan oluşturabilirsiniz. Her istekte Authorization header'ında Bearer token olarak gönderilmelidir.

// API Key ile kimlik doğrulama
curl -X GET "https://api.hivepetvet.com/api/v1/patients" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

OAuth 2.0

OAuth 2.0 ile daha güvenli ve esnek bir kimlik doğrulama yöntemi kullanabilirsiniz. Üçüncü parti uygulamalar için önerilir.

POST /oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}

Mevcut Endpoint'ler

Patients API

GET/api/v1/patientsHasta listesini getir
POST/api/v1/patientsYeni hasta oluştur
GET/api/v1/patients/{id}Hasta detaylarını getir
PUT/api/v1/patients/{id}Hasta bilgilerini güncelle

Appointments API

GET/api/v1/appointmentsRandevu listesini getir
POST/api/v1/appointmentsYeni randevu oluştur
PUT/api/v1/appointments/{id}Randevu güncelle
DELETE/api/v1/appointments/{id}Randevu sil

Medical Records API

GET/api/v1/records/{patientId}Hasta kayıtlarını getir
POST/api/v1/recordsYeni kayıt oluştur
GET/api/v1/records/{id}/attachmentsEk dosyaları getir

Inventory API

GET/api/v1/inventoryStok listesini getir
POST/api/v1/inventoryÜrün ekle
PUT/api/v1/inventory/{id}Stok güncelle

Webhooks

POST/api/v1/webhooksWebhook kaydet
GET/api/v1/webhooksWebhook listesini getir

Kod Örnekleri

Authentication

// API Key ile kimlik doğrulama
curl -X GET "https://api.hivepetvet.com/api/v1/patients" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Create Patient

// Yeni hasta oluşturma
curl -X POST "https://api.hivepetvet.com/api/v1/patients" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "owner_name": "Ahmet Yılmaz",
    "owner_phone": "+905551234567",
    "pet_name": "Pamuk",
    "pet_species": "Kedi",
    "pet_breed": "Tekir",
    "pet_birth_date": "2020-05-15"
  }'

Create Appointment

// Randevu oluşturma
curl -X POST "https://api.hivepetvet.com/api/v1/appointments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_id": 123,
    "appointment_date": "2026-02-15T10:00:00Z",
    "appointment_type": "checkup",
    "notes": "Rutin kontrol"
  }'

Rate Limits & En İyi Uygulamalar

Rate Limits

  • 1000 istek/saat - Standart planlar için
  • 5000 istek/saat - Pro planlar için
  • Sınırsız - Ultimate planlar için

En İyi Uygulamalar

  • API anahtarlarınızı güvenli tutun ve asla commit etmeyin
  • Hata yönetimi için HTTP status kodlarını kontrol edin
  • Rate limit aşımını önlemek için exponential backoff kullanın
  • Webhook'lar için idempotent işlemler yapın

API Anahtarı Al

Dashboard'unuza giriş yaparak API anahtarınızı oluşturun ve entegrasyona başlayın

Geliştirici Kaynakları

SDK'lar

JavaScript, Python ve PHP için resmi SDK'lar

Dokümantasyon

Detaylı API referansı ve örnekler

Topluluk

Geliştirici forumu ve destek