Turnike kurulum firmaları için
Turnike uyumluluğu
QR okuyuculu her turnike, basit bir HTTPS isteğiyle Gymvey’e bağlanabilir. Bu sayfa kurulum firmaları için entegrasyonun özetidir.
Nasıl bağlanır?
Üç adımda entegrasyon
1. Cihazı tanımlayın
Salon yöneticisi panelde turnikeyi cihaz olarak ekler; cihaz kodu ve yalnız bir kez gösterilen API anahtarı üretilir.
2. Okuyucuyu bağlayın
QR okuyucu okuduğu değeri HTTPS ile turnike.gymvey.com adresine gönderir; salon cihaz kodundan bulunur.
3. Kararı uygulayın
Yanıt "granted" ise röle açılır, "denied" ise kapı kapalı kalır ve neden ekranda gösterilir.
Erişim isteği
Her okumada bir istek gönderilir. Sunucu üyeliği, saat kısıtını, borç durumunu ve şube yetkisini kontrol edip karar verir.
POST https://turnike.gymvey.com/api/v1/turnstile/access
Content-Type: application/json
Accept: application/json
X-Turnstile-Device: DEV-A1B2C3D4E5F6
X-Turnstile-Key: <cihaz-api-anahtari>
{
"device_code": "DEV-A1B2C3D4E5F6",
"credential_type": "qr_token",
"credential": "<QR okuyucunun çözdüğü değer>",
"occurred_at": "2026-05-12T14:30:00+03:00"
}credential_type: qr_token (QR) veya member_no (üye numarası). Cihaz sağlığı için POST /api/v1/turnstile/ping 30 sn aralıkla gönderilir.
Yanıt
Karar her zaman HTTP 200 ile döner; access alanına göre davranın.
{
"access": "granted",
"action": "checkin",
"reason": null,
"member_id": 142,
"branch_id": 1,
"checkin_id": 9871,
"log_id": 33421
}- checkin
- Yeni giriş kaydı oluştu.
- checkout
- Çıkış kaydedildi (giriş-çıkış turnikeli salonlarda).
- repeat_entry
- Üye bugün zaten giriş yapmış; kapı açılır, panelde tek kayıt kalır.
- guest_pass
- Resepsiyondan üretilen tek seferlik misafir geçişi; kapı açılır.
- denied
- Reddedildi; "reason" alanındaki metin ekranda gösterilebilir.
Donanım davranışı
| Durum | Beklenen davranış |
|---|---|
| access = granted | Röleyi 2–3 sn açık tut, yeşil LED, kısa sinyal. |
| access = denied | Röleyi kapalı tut, kırmızı LED, uzun sinyal. |
| HTTP 4xx / 5xx | Röleyi açma; ekranda hata göster. |
| 3 sn içinde yanıt yok | Röleyi açma; 1 sn sonra yeniden dene. |
| Aynı QR 2 sn içinde tekrar | Donanım filtrelemeli; gereksiz istek gönderme. |
Hata kodları ve güvenlik
| HTTP | Anlamı |
|---|---|
| 401 | Bilinmeyen cihaz kodu veya hatalı API anahtarı |
| 403 | Cihaz pasif ya da IP izin listesi dışında |
| 422 | İstek gövdesi geçersiz |
| 429 | Hız limiti (dakikada 120 istek); 1 sn bekleyip yeniden deneyin |
- HTTPS zorunludur; sertifika doğrulamasını kapatmayın. Adres yönlendirme almaz, doğrudan yanıt verir.
- API anahtarı yapılandırma dosyasında kısıtlı izinlerle saklanmalıdır; sızarsa panelden anında yenilenir.
- Cihazın sabit IP’si panelde IP izin listesine yazılabilir.
Kurulum dokümanının tamamını mı istiyorsunuz?
Kurulum firmaları için ayrıntılı entegrasyon şartnamesini ve test senaryolarını gönderelim.