SOURCE: Vacation Tracker TITLE: Açık API (OpenAPI) nasıl kullanılır? URL: https://vacationtracker.io/tr/bilgi-tabani/acik-api-openapi-nasil-kullanilir/ LANG: tr PUBLISHED: 2026-10-06 UPDATED: 2026-11-02 READING: 4 min SUMMARY: Vacation Tracker Açık API eklentisiyle API anahtarı oluşturmayı, izinlerini seçmeyi, ilk isteğinizi göndermeyi ve değişikliklerden haberdar olmak için webhook eklemeyi öğrenin. # Açık API (OpenAPI) nasıl kullanılır? # Açık API (OpenAPI) nasıl kullanılır? Açık API eklentimiz Vacation Tracker'ı kendi araçlarınıza bağlar. Bir API anahtarı oluşturun, neler yapabileceğini seçin ve verilerinizi okumak ve değiştirmek ya da bir şey değiştiğinde bildirim almak için kullanın. ### Eğitim videosunu izleyin Açık API eklentisinin kısa bir anlatımı: ## API anahtarı nasıl oluşturulur? - app.vacationtracker.io/signin (https://app.vacationtracker.io/signin) adresinden Vacation Tracker hesabınıza giriş yapın. - Sol menüden (Çalışma alanı ayarları altında) Entegrasyonlar bölümünü açın. - API kartına tıklayın. Açık API sayfası açılır. - API anahtarları bölümünde API anahtarı oluştur seçeneğine tıklayın. - Bir Anahtar adı girin. Bu adı yalnızca şirketinizdeki kişiler görür. - İsterseniz bir Entegrasyon adı girin. Kişiler bu adı Vacation Tracker'da anahtarın yaptığı her değişikliğin yanında görür, örneğin “Jane tarafından onaylandı (Bordro senkronizasyonu aracılığıyla)”. Yalnızca kişinin adının görünmesi için boş bırakın. - İzinler altında bir şablon seçin ve gerekirse ayarlayın (aşağıya bakın). - Son kullanma altında anahtarın ne zaman sona ereceğini seçin: 30 gün içinde, 90 gün içinde, 1 yıl içinde (önerilen) veya hiçbir zaman. - Özet bölümünü kontrol edin ve API anahtarı oluştur seçeneğine tıklayın. - Anahtarı kopyalayın ve güvenli bir yerde saklayın. Tam anahtar yalnızca bir kez, oluşturulduğunda gösterilir. ## İzinleri seçme Bir şablonla başlayın, ardından ayarlayın: - Salt okunur: verileri görün, hiçbir şeyi değiştirmeyin. Raporlar ve gösterge panelleri için uygundur. - İzin yönetimi: izin talep edin, ekleyin ve onaylayın. Kullanıcıları ve izin türlerini okuyun. - Çalışma alanı kurulumu: konumları, departmanları, izin türlerini, politikaları, tatilleri ve kullanıcıları ayarlayın. - Özel: her izni kendiniz seçin. Her izin Erişim yok, Okuma veya Okuma ve yazma olarak ayarlanabilir. Talepleri onaylama ve reddetme, gizli izin türü adlarını görme ve diğer kullanıcılar adına işlem yapma ayrı onay kutularıdır; bu nedenle bunları yalnızca aracınızın ihtiyacı varsa açın. Bir anahtar yalnızca sizin Vacation Tracker'da yapmanıza izin verilen işlemleri yapabilir. ## Anahtarlarınızı yönetme API anahtarları tablosu, çalışma alanınızdaki her anahtarı sahibi, izinleri, son kullanımı, son kullanma tarihi ve durumuyla birlikte listeler. Ayrıntılarını açmak için bir anahtara tıklayın; burada şunları yapabilirsiniz: - Bu ayki kullanımı görün, anahtarın adını ve izinlerini düzenleyin. - Veri değiştiren her isteği listeleyen Son etkinlik bölümünü kontrol edin. - Aynı ad ve izinlerle yeni bir anahtar almak için Anahtarı yenile seçeneğine tıklayın. Eski anahtarın 24 saat (önerilen) veya 7 gün boyunca çalışmaya devam etmesini ya da hemen durmasını seçin. - Anahtarı kalıcı olarak durdurmak için İptal et seçeneğine tıklayın. Bir anahtarın süresi dolmadan 14 gün önce size e-posta göndeririz. ## İlk isteğinizi gönderme Temel URL https://api.vacationtracker.io/v2 adresidir. Anahtarınızı Authorization başlığında bearer token olarak gönderin: curl https://api.vacationtracker.io/v2/departments \ -H "Authorization: Bearer vt_live_..." Başarılı bir çağrı verileri data altında döndürür. Birden fazla sayfası olan listeler ayrıca bir nextToken içerir; sonraki sayfayı almak için bunu geri gönderirsiniz. { "data": [ ... ], "nextToken": "..." } Bir sorun olursa yanıt; bir kod, açıklama ve çözüm içeren bir error içerir. Eksik veya bilinmeyen bir anahtar 401 döndürür. Bir isteğin gerektirdiği izne sahip olmayan bir anahtar, INSUFFICIENT_SCOPE ile birlikte 403 döndürür. Tam teknik başvuru Tüm uç noktalar, parametreler, hata kodları ve webhook olayları geliştirici dokümantasyonumuzda (https://vacationtracker.io/developers/api-v2) yer alır. Dokümantasyonu Açık API eklentisi sayfasındaki Dokümantasyonu Aç düğmesiyle de açabilirsiniz. ## Webhook nasıl eklenir? - Açık API eklentisi sayfasında Webhook'lar bölümüne gidin ve Webhook'ları yönet seçeneğine tıklayın. - Webhook ekle seçeneğine tıklayın. - Olayları alacak Uç nokta URL'si değerini girin. HTTPS kullanmalıdır. - Olaylar altında İzin kararları, Tüm izin etkinlikleri, Tam bir kopyayı senkronize tut veya olayları kendiniz seçmek için Özel seçeneğini seçin. - Webhook ekle seçeneğine tıklayın. Yalnızca görmenize izin verilen verilerle ilgili olayları alırsınız. ## Kotalar ve hız sınırları Sınırlar API anahtarı başına uygulanır: - Ayda en fazla 30.000 istek. - En fazla 50 isteklik ani artışla birlikte saniyede 10 istek. Entegrasyonunuzun bundan fazlasına ihtiyacı varsa şirket adınızı, entegrasyonu ve beklediğiniz trafiği belirterek developers@vacationtracker.io (mailto:developers@vacationtracker.io) adresine e-posta gönderin. Eski API anahtarları API v2'den önce oluşturulan anahtarlar Eski anahtarlar (API v1) altında listelenir. Çalışmaya devam ederler, ancak yalnızca veri okuyabilirler ve API v2 ile çalışmazlar. API üzerinden veri değiştirmek için yeni bir anahtar oluşturun ve geçiş kılavuzumuzu (https://vacationtracker.io/developers/api-v2/migration) izleyin. ## Sık sorulan sorular API'yi mi, Zapier'i mi, yoksa MCP sunucusunu mu kullanmalıyım? Ne yaptığınıza bağlıdır. API, değişikliklere tepki vermek için webhook'larla birlikte kendi kodunuz ve araçlarınız içindir. Zapier kod gerektirmeyen seçenektir. MCP sunucusu ise Claude veya ChatGPT gibi bir yapay zekâ aracını bağlar; böylece sorularınızı doğal dille sorabilirsiniz. Birçok ekip birden fazlasını kullanır. API ek ücrete tabi mi? Hayır. Açık API eklentisi Core ve Complete planlarına ek ücret olmadan dahildir. Bir anahtarı kaybedersem ne olur? Tam anahtar yalnızca bir kez gösterilir ve kurtarılamaz. Yeni bir anahtar almak için anahtarı açın ve Anahtarı yenile seçeneğine tıklayın, ardından onu kullanan aracı güncelleyin. Eski anahtar sızmış olabilirse hemen durdurulmasını seçin. ### Sırada ne var? Vacation Tracker Zapier'e nasıl bağlanır? (https://vacationtracker.io/tr/bilgi-tabani/vacation-tracker-zapiere-nasil-baglanir/) Vacation Tracker, MCP sunucusuyla yapay zekâ araçlarıma nasıl bağlanır? (https://vacationtracker.io/tr/bilgi-tabani/vacation-tracker-mcp-sunucusuyla-yapay-zeka-araclarima-nasil-baglanir/) İzin talebi raporu (izin geçmişi) nasıl dışa aktarılır? (https://vacationtracker.io/tr/bilgi-tabani/izin-talebi-raporu-izin-gecmisi-nasil-disa-aktarilir/) Yardıma mı ihtiyacınız var? Destek ekibimizle e-posta veya sohbet üzerinden, pazartesiden cumaya 09.00–17.00 (ABD Doğu Saati, EST) arasında iletişime geçin.