Quire Ağ Kancalarını Kurma Rehberi: Adım Adım

Son güncelleme: 24 Temmuz 2026

Uygulamalarınızın otomatik olarak birbiriyle konuşmasını hiç istediniz mi? Ağ kancalarının yaptığı tam olarak bu! Onları, Quire projelerinizde bir şey olduğu anda sunucunuzu haberdar eden habercilar olarak düşünün — ister yeni bir görev oluşturulsun, ister biri bir atamayı güncellesin, ister bir görevi tamamlanmış olarak işaretlesin.

Bu rehberde, uygulamalarınızı Quire ile senkron tutmak için ağ kancalarını nasıl kuracağınızı, siz parmağınızı bile kıpırdatmadan göstereceğiz.

Quire Ağ Kancalarına Nasıl Başlanır?

Adım 1: Quire Uygulamanızı Oluşturun

Her şeyden önce bir Quire uygulamasına ihtiyacınız olacak. Henüz bir tane kurmadıysanız, Quire API ile Quire Uygulaması Oluşturma rehberimize göz atın; size adım adım anlatalım.

Adım 2: Quire'a Güncellemeleri Nereye Göndereceğini Söyleyin

Şimdi sıra Quire Geliştirici Uygulamaları portalında ağ kancası uç noktanızı kurmaya geldi. Bu, basitçe Quire'ın bildirimleri göndermesini istediğiniz web adresi — http://myserver/hookhandler gibi bir şey.

Bunu, Quire'a haberleri nereye teslim edeceğini bilmesi için posta adresinizi vermek gibi düşünün.

Adım 3: Güncellemelere Abone Olun

Son kurulum adımı, Quire'a hangi projeleri veya görevleri takip etmek istediğinizi bildirmektir. Bunu, uygulamanızı Quire API'sini kullanarak bir "takipçi" olarak ekleyerek yaparsınız:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app"]}' \
  https://quire.io/api/project/projectAOid

Önemli not: Bu adımdan önce ağ kancası URL'nizi zaten yapılandırdığınızdan emin olun. Yapılandırmazsanız, uygulamanızı takipçi olarak eklemek işe yaramaz.

Güncellemelere artık ihtiyaç duymadığınızda, uygulamanızı basitçe takipçi listesinden kaldırın. Bu kadar basit!

Daha fazla ayrıntı için API referansımızdaki OID'ye göre bir projeyi güncelleme bölümüne göz atın.

Ağ Kancaları Perde Arkasında Nasıl Çalışır?

Ne Alacaksınız

Her şey kurulduktan sonra, Quire takip ettiğiniz projelerde bir şey olduğunda size bildirim göndermeye başlar. Bunlar, tüm ayrıntıların düzenli bir JSON paketi içinde yer aldığı POST istekleri olarak gelir:

{
  "type": "notification",
  "secret": "your-app-secret",
  "data": {
    "type": 0, 
    "when": "2019-09-30T08:20:12.000Z",
    "what": {
      "oid": "YxjapXXRCOYxoaiCT4tT3OQm", 
      "id": 101,
      "name": "Brand new start"
    },
    "user": {
      "oid": "1AbDEFed2A5031BEDDweqmde",
      "id": "john.doer",
      "name": "John Doer"
    },
    "message": "<a href=\"https://quire.io/u/john.doer\">John Doer</a> added <a href=\"https://quire.io/w/MyProjects/101\">Brand new start</a>",
    "text": "John Doer added Brand new start",
    "url": "https://quire.io/w/MyProjects/101"
  } 
}

Önce Güvenlik: Kaynağı Doğrulayın

Her ağ kancası, uygulamanızın gizli anahtarını içerir. Bu, mesajın gerçekten Quire'dan geldiğini ve bizmiş gibi davranan biri olmadığını doğrulamanın yoludur. Herhangi bir veriyi işlemeden önce bunu her zaman kontrol edin!

Farklı Olaylara Yanıt Verme

Projelerinizde farklı şeyler olur ve bunları farklı şekillerde ele almak isteyeceksiniz. İşte ne olduğuna göre nasıl yanıt vereceğinize dair basit bir örnek:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    log("New task: " + json["data"]["what"]["name"]);
    break;
  case 1:
    // task removed
    log(json["data"]["user"]["name"] + " deleted " + json["data"]["what"]["name"]);
    break;
}

Quire Hangi Olay Türlerini Gönderir?

Quire her türlü etkinlik hakkında size bildirim gönderebilir. İşte en yaygın olanlardan bazıları:

Tam listeyi mi istiyorsunuz? Quire'ın size anlatabileceği her şeyi görmek için etkinlik türleri belgelerimize göz atın.

Quire'a Mesajı Aldığınızı Bildirmek

Ağ kancanız bir bildirim aldığında, geriye bir başarı durum kodu gönderin (200 ile 299 arasında herhangi biri). Bu, Quire'a "Aldım, teşekkürler!" der.

Bir şeyler ters giderse ve farklı bir durum kodu gönderirseniz, endişelenmeyin — Quire bildirimi 15 dakika sonra, ardından 1 saat sonra ve son olarak 1 gün sonra tekrar göndermeyi dener.

Daha fazla ayrıntı için API belgelerimizdeki "Yanıtlama ve Yeniden Denemeler" bölümüne bakın.

Birden Fazla Projede Ağ Kancalarını Nasıl Yönetirsiniz?

Aynı sunucuda birkaç Quire projesiyle mi çalışıyorsunuz? İki esnek yaklaşımla sizi koruma altına alıyoruz:

Seçenek 1: Özel Etiketler Kullanın

Proje güncellemelerine abone olurken özel bir etiket ekleyebilirsiniz:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|handleProjectA"]}' \
  https://quire.io/api/project/projectAOid

Quire bu etiketi her ağ kancası bildirimine dahil eder, böylece hangi projenin gönderdiğini kolayca belirleyebilirsiniz:

{
  "type": "notification",
  "team": "handleProjectA",
  "data": {
    // event details...
  }
}

Ardından kodunuzda, bildirimleri buna göre yönlendirebilirsiniz:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    if (json["team"] == "handleProjectA") {
      log("ProjectA has a new task: " + json["data"]["what"]["name"]);
    }
    break;
}

Seçenek 2: Farklı Yollar Kullanın

Her şeyi ayrı tutmayı mı tercih ediyorsunuz? Her proje için benzersiz yollar oluşturun:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|/projectAUpdate"]}' \
  https://quire.io/api/project/projectAOid

Bu şekilde, Quire bildirimleri ana uç noktanızın farklı alt yollarına gönderir (http://myserver/hookhandler/projectAUpdate gibi) ve her projeyi kendi özel işleyicisiyle ele alabilirsiniz.

İlk Ağ Kancanıza En Hızlı Yol Nedir?

Hepsi bu kadar! Artık ağ kancalarını nasıl kuracağınızı ve uygulamalarınızı Quire ile mükemmel senkronda nasıl tutacağınızı biliyorsunuz. Eksiksiz teknik belgeler için API referansımızdaki Ağ Kancası bölümüne göz atın.

Özel bir sunucu yerine bir yapay zeka asistanı için mi geliştiriyorsunuz? Claude, ChatGPT veya herhangi bir yapay zeka istemcisini doğrudan bağlamak için 5 Dakikada Quire MCP Kurulumu yazımıza göz atın.

İyi geliştirmeler!

Sıkça Sorulan Sorular

Quire ağ kancası nedir?

Takip edilen bir projede bir şey gerçekleştiği anda Quire'ın kontrolünüzdeki bir URL'ye gönderdiği otomatik bir HTTP bildirimi — böylece uygulamanız yoklama yapmadan senkron kalır.

Quire'da bir ağ kancasını nasıl kurarım?

Bir Quire uygulaması oluşturun, Geliştirici Uygulamaları portalında uç nokta URL'nizi kaydedin, ardından uygulamanızı API üzerinden bir proje takipçisi olarak ekleyin. Abone olmadan önce URL'yi yapılandırın, aksi takdirde çağrı başarısız olur.

Bir ağ kancası isteğinin gerçekten Quire'dan geldiğini nasıl doğrularım?

Her yük, uygulamanızın secret alanını içerir — bunu saklanan gizli anahtarınızla karşılaştırın ve eşleşmeyen her isteği reddedin.

Bir ağ kancası tetiklendiğinde sunucum kapalıysa ne olur?

Quire üç kez yeniden dener: 15 dakika, 1 saat ve 1 gün sonra. Daha fazla yeniden denemeyi durdurmak için yükü aldığınız anda bir 2xx durumu döndürün.

Tek bir sunucuda birden fazla Quire projesi için ağ kancalarını nasıl yönetirim?

Ya abone olurken özel bir etiket ekleyin (örneğin app|handleProjectA) ve team alanına göre yönlendirin, ya da her projeye ağ kancası URL'nizde kendi alt yolunu verin.