Sürüm: 2.0
Tarih: 13 Ocak 2026
Base URL: https://{{domain}}/api/v2
1. GİRİŞ VE KİMLİK DOĞRULAMA (AUTHENTICATION)
Gurulize API servislerine erişmek için tüm HTTP isteklerinde aşağıdaki Header bilgisi zorunludur:
Header | Değer | Açıklama |
X-APi-Key | {{apikey}} | Size özel tanımlanan API anahtarı. |
2. KULLANICI MODÜLÜ (USERS)
Sistemdeki kullanıcı verilerine erişim sağlar.
2.1. Tüm Kullanıcıları Listele
Sistemdeki tüm kullanıcı kayıtlarını getirir.
İstek (Request): GET https://{{domain}}/api/v2/users
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/users
2.2. ID ile Kullanıcı Detayı
Belirli bir kullanıcının profil verilerine erişmek için kullanılır.
İstek (Request): GET https://{{domain}}/api/v2/users/{id}
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/users/4
3. PAKET MODÜLÜ (PACKAGES)
Uzmanların sunduğu seans veya hizmet paketlerine erişim sağlar.
3.1. Tüm Paketleri Listele
Uzmanların sunduğu seans veya hizmet paketlerine erişim sağlar.
İstek (Request): GET https://{{domain}}/api/v2 /packages
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/packages
3.2. ID ile Paket Detayı
Belirli bir paketin içeriğini ve detaylarını döner.
İstek (Request): GET https://{{domain}}/api/v2/packages/{id}
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/packages/12
4. BLOG MODÜLÜ
Blog içeriklerine erişim sağlar.
4.1. Bloglar
4.1. Blog Listesi
Sistemdeki tüm blog içeriklerine erişim sağlar.
İstek (Request): GET https://{{domain}}/api/v2/blogs
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/blogs
4.2. Blog Detayı
Belirli bir blog yazısının içeriğini getirir.
İstek (Request): GET https://{{domain}}/api/v2/blogs/{id}
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/blogs/7
4. KATEGORİ MODÜLÜ (CATEGORIES)
Uzmanlık ve hizmet kategorilerine erişim sağlar.
4.1. Kategori Listesi
Sistemdeki uzmanlık ve hizmet kategorilerini listeler.
İstek (Request): GET https://{{domain}}/api/v2/categories
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/categories
4.2. Kategori Detayı
Belirli bir kategorinin detay bilgilerini getirir.
İstek (Request): GET https://{{domain}}/api/v2/categories/{id}
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/categories/37
5. ETKİNLİK MODÜLÜ (EVENTS)
Etkinlik takvimi ve etkinlik bilgilerine erişim sağlar.
5.1. Etkinlik Listesi ve Filtreleme
Etkinlik takvimini sorgulamak için kullanılır.
İstek (Request): GET https://{{domain}}/api/v2/events
Kullanılabilir Sorgu Parametreleri:
Parametre | Tip | Açıklama |
status | int | Etkinlik durumu. 0 ya da 1 (Örn: 1) |
fromdate | date | Başlangıç (Format: DDMMYYYY) (Örn: 01012026) |
todate | date | Bitiş (Format: DDMMYYYY) (Örn: 05012026) |
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/events?status=1&fromdate=01012026&todate=05012026
5.2. Etkinlik Detayı
Belirli bir etkinliğin detaylarını getirir.
İstek (Request): GET https://{{domain}}/api/v2/events/{id}
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/events/1
6. UZMAN MODÜLÜ (EXPERTS)
Uzman profilleri ve gelişmiş takvim servisleri.
6.1. Uzman Listesi ve Profili
Uzmanların listesine ve alt detaylarına erişim sağlar.
6.1.1 Uzman Listesi
Sistemdeki uzmanları listeler.
İstek (Request): GET https://{{domain}}/api/v2/experts
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/ experts
6.1.2 Uzman Profili
Belirli bir uzmanın detay bilgilerini getirir.
İstek (Request): GET https://{{domain}}/api/v2/experts/{id}
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/experts/1
6.1.3 Uzman Kategorileri
Belirli bir uzmanın hizmet kategorilerini listeler.
İstek (Request): GET https://{{domain}}/api/v2/experts/{id}/categories
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/experts/1/categories
6.1.4 Uzman Servisleri
Belirli bir uzmanın servislerini listeler.
İstek (Request): GET https://{{domain}}/api/v2/experts/{id}/services
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/experts/1/services
6.1.4 Uzman Paketleri
Belirli bir uzmanın seans veya hizmet paketlerini listeler.
İstek (Request): GET https://{{domain}}/api/v2/experts/{id}/package
İstek (Request) Örneği:
GET https://{{domain}}/api/v2/experts/1/package
6.2. Gelişmiş Takvim Sorgulama (Available Slots)
Belirtilen kriterlere göre uzmanların en yakın boş slotları bilgisine erişim sağlanır.
Endpoint: GET https://{{domain}}/api/v2/experts/calendar/available
Parametre | Tip | Açıklama |
category | int | Uzmanların bağlı olduğu kategori ID. |
packageid | int | Belirli bir paketin sığabileceği slotları arar. (Verilmezse duration dikkate alınır. Packageid ve duration ikisi de verilmezse en ucuz paketin bilgisi kullanılır.) |
duration | int | Dakika cinsinden seans süresi (packageid yoksa bu değer kullanılır). |
breaklength | int | Seans sonuna eklenecek mola süresi (varsayılan: 0). |
fromdate | date | Başlangıç (Format: DDMMYYYYHHMMSS). |
todate | date | Bitiş (Max aralık fromdate değerinden 7 gün sonrası, Format: DDMMYYYYHHMMSS). |
limit | int | Dönecek kayıt sayısı (Varsayılan: 3). |
uniqueexpert | bool | true ise her uzman için sadece en yakın tek bir slot döner. |
7. ÖRNEK CURL İSTEĞİ
Herhangi bir API servisini altta ki örneğe benzer şekilde kullanabilirsiniz:
curl --location 'https://{{domain}}/api/v2/experts/calendar/available?category=1&limit=4&uniqueexpert=true' \
--header 'X-APi-Key: YOUR_API_KEY'