Quire API ile İki Yönlü Senkronizasyon Nasıl Kurulur: Bir Geliştiricinin Bakış Açısı

Son güncelleme: 20 Temmuz 2026

Veriler iki uygulamada yaşadığında, her işlem iki kez yapılır ya da sessizce senkronizasyon dışı kalır. İki yönlü senkronizasyon, Quire ile diğer uygulamanın güncellemeleri ağ kancaları aracılığıyla otomatik olarak değiş tokuş etmesini sağlayarak bu çift giriş sorununu ortadan kaldırır. Quire'ın Açık API'si tam olarak bu model için tasarlanmıştır.

Bağlantısız araçların maliyeti iyi belgelenmiştir. McKinsey'nin sosyal ekonomi araştırmasına göre, bilgi işçileri haftalarının yaklaşık %20'sini asıl işlerini yapmak yerine dahili bilgi aramakla geçiriyor. Güvenilir bir senkronizasyon, bu yükün bir kısmını otomatik olarak ortadan kaldırır.

Google Takvim İki Yönlü Senkronizasyon uygulaması kanonik örnektir: Quire görevleri ve Google Takvim etkinlikleri, manuel uzlaştırma gerektirmeden hizalı kalır. Bu yazı, aynı modelin başka herhangi bir uygulamanın API'sine karşı nasıl kurulacağını anlatıyor.

Google Takvim İki Yönlü Senkronizasyon, Premium ve üzeri abonelik seviyeleri için tasarlanmıştır. Daha fazla bilgiyi Fiyatlandırma sayfamızda bulabilirsiniz.

Quire iki yönlü senkronizasyonun bileşenleri

İki Yönlü Senkronizasyon İş Akışı Nedir?

İki yönlü senkronizasyonu, iki uygulama arasındaki bir konuşma olarak düşünün. Quire'da bir görevi güncellediğinizde, diğer uygulamaya bu değişikliği bildirir. Diğer uygulamada bir şey güncellendiğinde de Quire'a bildirilir. Bu, bilgilerinizin her yerde tutarlı kalmasını sağlar.

Uygulama Adımları Nelerdir?

Quire Uygulamanızı kurmak ilk adımdır. Quire projenize API üzerinden erişmek için gereken kimlik bilgilerini almak için bir tane oluşturmanız gerekecek.

Quire API ile kendi uygulamanızı nasıl oluşturacağınıza dair adım adım bir kılavuz için blog yazımızı ziyaret edin.

İki yönlü senkronizasyon uygulamak için, Quire ile hedef uygulamanız (Google Takvim gibi) arasında köprü görevi görecek bir ara katman uygulaması (sizin uygulamanız) geliştirmeniz gerekir. Bunu bir çevirmen gibi düşünün: bir taraftan bilgi alır, işler ve ardından diğer tarafa doğru komutları gönderir. Akış şöyle görünür: Quire ↔ Uygulamanız ↔ Diğer Uygulama.

Adım Adım Nasıl Kurulur?

1. Olayları işlemek için bir uygulama hazırlayın

İki yönlü senkronizasyonu etkinleştirmek için önce ara katman görevi görecek kendi sunucu uygulamanızı kurmanız gerekir. Bu uygulama, hem Quire'dan hem de diğer uygulamadan gelen ağ kancası POST isteklerini almaktan sorumlu olacak. Sunucunuz şunları yapabilmelidir:

• Quire ve diğer uygulamadan gelen HTTP POST isteklerini (ağ kancası olaylarını) kabul etmek.
• Olay yüklerini ayrıştırmak ve hangi eylemlerin gerekli olduğunu belirlemek.
• Gerektiğinde Quire veya diğer uygulamadaki verileri güncellemek için ilgili API'leri kullanmak.

Bu sunucu uygulamasını Node.js, Python veya Ruby gibi tercih ettiğiniz herhangi bir teknolojiyle oluşturabilirsiniz. Aşağıdaki bölümlerde, ağ kancası olaylarını almanın ve işlemenin basit bir örneğini göstermek için Node.js kullanacağız. Sunucunuzun, Quire ve diğer uygulamanın ona ağ kancası olayları gönderebilmesi için internetten erişilebilir olduğundan emin olun.

İşte Express kullanan basit bir Node.js örneği:

const express = require('express');
const app = express();
app.use(express.json());

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

2. Görev güncellemelerini uygulamanıza göndermek için Quire'da bir ağ kancası ayarlayın.

Ardından, Quire'dan gelen ağ kancası olaylarını almak için sunucunuzda bir rota oluşturmanız gerekecek.

app.post('/webhook', (req, res) => {
  console.log('Received webhook event:', req.body);
  // TODO: Handle the event and update Quire or other app via API
  res.status(200).send('Event received');
});

Bu örnekte, ağ kancası rotası /webhook'tur, dolayısıyla tam URL ${your-host}/webhook olacaktır.

Bu ağ kancası URL'sini kopyalayıp Quire uygulama ayarlarına yapıştırın, böylece Quire olay bildirimlerini uygulamanıza nereye göndereceğini bilir.

Ayrıca, Quire uygulamanızı senkronize etmek istediğiniz projenin bir takipçisi olarak kaydetmeniz gerekir. Bu, uygulamanızın ilgili güncellemeler için bildirim almasını sağlar.

Quire API ile bildirimlerin nasıl alınacağına dair adım adım bir kılavuz için kılavuzumuzu ziyaret edin.

3. Diğer uygulamada, güncellemelerini uygulamanıza göndermesi için bir ağ kancası ayarlayın.

Diğer uygulamadan gelen güncellemeleri Quire ile senkronize etmek için, o uygulamadan ağ kancası olaylarını almak üzere sunucunuzda da bir rota oluşturmanız gerekecek. Kayıt süreci, Quire için yukarıda gösterilen örneğe benzer. Diğer uygulamayı, olay bildirimlerini ara katman uygulamanızın ağ kancası uç noktasına gönderecek şekilde yapılandırmanız ve sunucunuzun bu gelen olayları uygun şekilde işleyebildiğinden emin olmanız yeterli.

4. Gelen olayları işleyin ve API'lerini kullanarak hem Quire'daki hem de diğer uygulamadaki verileri güncelleyin.

Uygulamanız hem Quire'dan hem de diğer uygulamadan ağ kancası olayları almaya başladığında, bu olayları işlemek ve iki platform arasında verileri senkronize etmek için bir mantık uygulamanız gerekecek. Bu genellikle şunları içerir:

• Neyin değiştiğini belirlemek için olay yüklerini ayrıştırmak (örn. görev oluşturuldu, güncellendi veya silindi). Olay yapısı hakkında daha fazla ayrıntı için Quire API Dokümanı - Bildirim Olayları sayfasına başvurabilirsiniz.
• Bu değişiklikleri diğer uygulamaya yansıtmak için hangi API çağrılarının gerektiğini belirlemek.
• Verileri senkronize tutmak için Quire'a veya diğer uygulamaya uygun API isteklerini göndermek.
• Güncellemelerin doğru şekilde bağlanmasını sağlamak için Quire görev ID'leri ile uygulamanızın öğe ID'leri arasında bir eşleştirme tutmak.

Gelen olayları dikkatle işleyip verileri API'ler aracılığıyla güncelleyerek, uygulamanız değişikliklerin her iki tarafta da doğru şekilde yansıtılmasını ve güvenilir bir iki yönlü senkronizasyonun sürdürülmesini sağlar.

İşte Node.js ve axios kullanan bir örnek:

const axios = require('axios');

app.post('/webhook', (req, res) => {
  const { type } = req.body.data;
  // Reference of activity types: 
  // https://github.com/quire-api/quire-api/blob/master/docs/activity_types.md
  switch (type) {
    case 0: //Quire task created
      onQuireTaskCreate();
      break; 
    case 1: //Quire task deleted
      onQuireTaskDelete();
      break;
  }
  res.status(200).send('Event received');
});

// Route for handling events from another app to Quire
app.post('/anotherwebhook', async (req, res) => {
  const { isCreate, id, name, projectId } = req.body;
  if (isCreate) {
    // Create a task in the Quire project
    await axios.post(`https://quire.io/api/task/${projectId}`, { name });
    // Optionally, store the mapping between your app's id and Quire's task id
  } else {
    // Retrieve the corresponding Quire task id using your mapping logic
    const taskOid = getTaskIdByAppEventId(id, projectId);
    // Delete the task from the Quire project
    await axios.delete(`https://quire.io/api/task/${taskOid}`);
  }
  res.status(200).send('Event processed successfully');
});

Bu örnek, diğer uygulamadan gelen oluşturma ve silme olaylarının nasıl işlenip Quire ile senkronize edileceğini gösteriyor. Güvenilir senkronizasyon için doğru hata yönetimini uyguladığınızdan ve ID eşleştirmesini sürdürdüğünüzden emin olun.

Önemli Hususlar Nelerdir?

İki güvenlik kuralı, her ilk uygulamayı ısıran hata modlarını kapsar:

• Her değişikliğin kaynağını takip edin. Senkronizasyon sürecinizin tetiklediği güncellemeleri etiketleyin ve bunlar bir ağ kancası olarak geri döndüğünde yok sayın. Bu olmadan, Quire diğer uygulamaya gönderir, diğer uygulama sunucunuza geri bir ağ kancası tetikler, sunucunuz tekrar gönderir ve döngü sonsuza kadar sürer.
• Veri formatlarını tutarlı tutun. Quire'da bir anlam ifade eden bir alan (Markdown açıklaması gibi), bir takvim etkinliği açıklaması, düz metin sorun notu veya başka bir hedef format olarak yer almadan önce açık bir dönüştürme gerektirebilir.

Sıradaki Adım Nedir?

Açık API artı ağ kancaları, Quire ve diğer araçlarınızı birbiriyle yarışan iki kaynak yerine tek bir gerçek kaynağına dönüştürür. En küçük uygulanabilir senkronizasyonla (tek olay türü, tek yön) başlayın ve genişletmeden önce döngünün baştan sona çalıştığını doğrulayın.

İlgili: Quire API Üzerinden Harici Araçları Entegre Etme — Örnek Olarak n8n Kullanımı — özel bir sunucu yerine kodsuz bir otomasyon aracıyla başlamak isterseniz işlenmiş bir örnek.

Sıkça Sorulan Sorular

Quire ile başka bir uygulama arasında iki yönlü senkronizasyon nedir?

Güncellemelerin her iki yöne de aktığı çift yönlü bir bağlantı: Quire'daki değişiklikler diğer uygulamaya gönderilir, oradaki değişiklikler de Quire'a geri gönderilir. Google Takvim İki Yönlü Senkronizasyon uygulaması çalışan bir örnektir.

Quire API ile iki yönlü senkronizasyon kurmak için neye ihtiyacım var?

API kimlik bilgilerine sahip bir Quire uygulaması, ağ kancalarını almak için internetten erişilebilir bir ara katman sunucusu ve iki API arasındaki olayları çevirecek bir mantık. Herhangi bir arka uç dili işe yarar.

Ara katman uygulaması hangi rolü oynar?

Quire ile diğer servis arasında bir çevirmen görevi görür, ağ kancası olaylarını alır, hangi API çağrılarının yapılacağına karar verir ve Quire görev ID'leri ile diğer uygulamanın öğe ID'leri arasındaki eşleştirmeyi sürdürür.

Sonsuz senkronizasyon döngülerini nasıl önlerim?

Her değişikliğin nereden kaynaklandığını takip edin ve kendi senkronizasyon sürecinizin tetiklediği güncellemeleri yok sayın. Bu önlem olmadan, her güncelleme iki uygulama arasında sonsuza kadar gidip gelir.

Google Takvim İki Yönlü Senkronizasyon için hangi Quire planı gereklidir?

Premium ve üzeri. Güncel seviye sınırlarını fiyatlandırma sayfasında kontrol edin.