Quire API Aracılığıyla Harici Araçları Quire ile Entegre Etme — Örnek Olarak n8n

Son güncelleme: 20 Temmuz 2026

Quire, Quire görevlerini programatik olarak okumanızı ve güncellemenizi sağlayan açık bir API sunar. Uygulama Dizini'ndeki birçok uygulama, doğrudan Quire API ile etkileşime girerek oluşturulmuştur.

Mevcut bir uygulama ihtiyaçlarınızı karşılamıyorsa, özel bir entegrasyon oluşturun. Bu makale, örnek bir otomasyon platformu olarak n8n kullanarak Quire API'yi ele alır; aynı kavramlar Zapier gibi diğer düşük kodlu platformlar için de geçerlidir.

Bu yol giderek yaygınlaşıyor. Gartner, 2025 yılına kadar organizasyonlar tarafından geliştirilen yeni uygulamaların %70'inin düşük kodlu veya kodsuz teknolojiler kullanacağını tahmin etti; bu oran 2020'de %25'in altındaydı. n8n, bu kategoride en yaygın kullanılan açık kaynaklı seçeneklerden biridir.

Bu rehberde kullanılan Quire API endpointleri

Uygulama Adımları Nelerdir?

1. API kimlik bilgilerini almak için Quire'da bir uygulama oluşturun
2. Bir n8n örneği hazırlayın ve çalıştırın
3. n8n'de OAuth2 ile kimlik doğrulaması yapın
4. İlk API isteğini gönderin (görevleri okuma)
5. API ile görev oluşturun veya değiştirin (yazma)
6. Kaynak referanslarını veya özel meta verileri saklamak için sourceRef kullanın

1. Quire'da bir uygulama oluşturun

Quire API'ye erişmek için Quire'da bir uygulama kaydetmeniz, bir istemci kimliği ve istemci sırrı almanız ve OAuth2 için bir yönlendirme URI'si yapılandırmanız gerekir.

Quire Uygulamanızı API ile nasıl oluşturacağınıza dair adım adım bir rehber için lütfen blog yazımızı ziyaret edin.

2. n8n'i hazırlayın

Test için n8n'i (ücretsiz) kendi sunucunuzda barındırabilirsiniz. Bu resmi belgeye göz atabilirsiniz.

Çalışmaya başladığında, API isteklerini gerçekleştirmek ve yanıtları işlemek için düğümler ekleyeceğiniz yeni bir iş akışı oluşturun.

3. OAuth2 ile kimlik doğrulaması yapın

Quire, yetkilendirme için OAuth2 kullanır. n8n, bir kimlik bilgisi oluşturduğunuzda token değişimini sizin için yöneterek yardımcı olur.

• İş akışı görünümünde, yeni bir kimlik bilgisi ekleyin ve OAuth2 seçeneğini seçin.

• Quire uygulama ayarlarınızdan istemci kimliğini, istemci sırrını, yetkilendirme URL'sini, token URL'sini ve yönlendirme URI'sini girin. Yönlendirme URI'si, doğru OAuth2 akışını sağlamak için n8n'den kopyalanıp Quire uygulama ayarlarınıza yapıştırılmalıdır. n8n'de, kimlik bilgilerinin Quire tarafından gerekli olan doğru biçimde gönderilmesini sağlamak için "Authentication" alanını Body olarak ayarlamanız gerekir.

• Hesabıma bağlan'a tıklayın, n8n sizi Quire'ın yetkilendirme sayfasına yönlendirecektir. Yetkilendirilecek projeyi seçin ve akışı tamamlayın.

4. İlk API isteğinizi gönderin (görevleri okuma)

Quire API belgeleri: https://quire.io/dev/api/

API'yi çağırmak için n8n'in HTTP Request düğümünü kullanın. Örnek olarak, bir projenin tüm kök görevlerini alın:

• Temel URL: https://quire.io/api
• Endpoint: /task/list/id/{projectId} ({projectId} yerine proje URL'nizden alınan proje kimliğini kullanın, genellikle https://quire.io/w/<projectId> şeklindedir)

HTTP Request düğümünde:

• Yöntem: GET
• URL: https://quire.io/api/task/list/id/<your_project_id>
• Authentication: Generic Credential Type
• Generic Auth Type: OAuth2 API
• OAuth2 API: <az önce oluşturduğunuz kimlik bilgisi>

Yanıt verisini sağ paneldeki görmek için düğümü çalıştırın; bu veriyi işlenmek üzere sonraki düğümlere aktarabilirsiniz.

5. Görev oluşturma veya değiştirme (yazma)

API'yi kullanarak görevler oluşturabilirsiniz (belgelerdeki Yeni bir görev ekleme bölümüne bakın).

• Endpoint: /task/id/{projectId}

n8n'in HTTP Request düğümünde:

• Yöntem: POST
• URL: https://quire.io/api/task/id/<your_project_id>
• Send Body'yi etkinleştirin ve gerekli alanları (örn. name) ve description gibi isteğe bağlı alanları girin.

Send Body'yi etkinleştirdikten sonra, Body Content Type'ı JSON ve Specify Body'yi Using JSON olarak ayarladığınızdan emin olun. Bu, aşağıdaki örnek koda uygun şekilde istek gövdenizi JSON biçiminde girmenizi sağlar:

{
  "name": "Example task",
  "description": "Created via n8n"
}

Düğümü çalıştırın; yanıt, oluşturulan görev detaylarını içerecek ve görevi Quire projenizde görmeniz gerekir.

6. Kaynak referansları ve özel veriler için sourceRef kullanın

sourceRef içeren örnek istek gövdesi:

{
  "name": "Task from n8n",
  "description": "Automated task",
  "sourceRef": {
    "text": "[Open in MyApp](https://example.com/item/123)",
    "meta": { "workflowId": "n8n-abc-123" }
  }
}

sourceRef, bir göreve ilişkin özel verileri saklamak için tasarlanmıştır. Önceden tanımlanmış tek alan, Markdown'ı destekleyen ve Quire görev detaylarında gösterilecek olan text alanıdır; kullanıcıların tıklayabileceği bağlantılar veya kısa açıklamalar için idealdir. sourceRef altına eklediğiniz diğer alanlar tamamen uygulamanıza bağlıdır; örneğin, otomasyonunuz için tanımlayıcıları veya bayrakları saklamak üzere bir meta nesnesi veya başka anahtarlar ekleyebilirsiniz, ancak bunlar isteğe bağlıdır.

API üzerinden bir görevi okuduğunuzda, döndürülen JSON'da sourceRef nesnesini arayın. text alanına ve sakladığınız herhangi bir özel veriye erişebilir, böylece otomasyonunuzun kökeni takip etmesini ve daha sonraki işlemler için ek bilgi taşımasını kolaylaştırabilirsiniz.

Bir görev oluştururken veya güncellerken kullanışlı olan başka bir alan da asUser'dır.

asUser'ı true olarak ayarlarsanız, etkinlik günlüğü görevi oluşturan veya güncelleyen kullanıcı olarak Quire uygulamasının adını gösterecektir. Bu, kullanıcıların hangi görevlerin bir API entegrasyonu tarafından oluşturulduğunu belirlemesine yardımcı olur.

Quire API Hatalarını Nasıl Ele Alırsınız?

Quire API'yi çağırırken karşılaşacağınız hemen hemen her sorun dört HTTP durum koduna dayanır. Her birinin belirli bir çözümü vardır:

• 401 Unauthorized: OAuth2 token'ınızın geçerli ve süresinin dolmadığını kontrol edin. Kimlik bilgisi kurulumunuzun doğru olduğundan emin olun.
• 400 Bad Request: İstek gövdenizi ve parametrelerinizi gözden geçirin. JSON biçiminin doğru olduğundan ve gerekli alanların dahil edildiğinden emin olun.
• 403 Forbidden: Uygulamanızın ve kullanıcınızın projeye veya kaynağa erişim izni olduğunu doğrulayın.
• 404 Not Found: Kullandığınız API endpoint'ini ve proje/görev kimliklerini tekrar kontrol edin.

Hata mesajları ve gerekli parametreler hakkında detaylar için her zaman Quire API belgelerine başvurun. Bir hatayla karşılaşırsanız, yanıt mesajını dikkatlice okuyun. Genellikle neyin yanlış gittiğine dair ipuçları içerir.

Quire API ile Çift Yönlü Senkronizasyonu Nasıl Uygularsınız?

Referans verilen makalede açıklandığı gibi, n8n ve Quire API kullanarak kendi çift yönlü senkronizasyon çözümünüzü de oluşturabilirsiniz.

Pratik bir örnek için açık kaynaklı deponuza göz atın: n8n Quire API. Bu depo, adım adım bir rehber ve çalışan bir şablon sunarak uygulamanız ile Quire arasında çift yönlü senkronizasyon uygulamanızı kolaylaştırır.

Quire API ile çift yönlü senkronizasyonun nasıl kurulacağına dair adım adım bir rehber için lütfen blog yazımızı ziyaret edin.

Sırada Ne Var?

Artık görevleri okumak, görev oluşturmak, sourceRef ile köken meta verisi eklemek ve asUser ile entegrasyonunuzu etkinlik günlüğünde tanımlamak için ihtiyacınız olan her şeye sahipsiniz. Aynı yöntemler diğer Quire API endpointlerine de uzanır; resmi API belgeleri yetkili referanstır.

Sorunlarla karşılaşırsanız, yukarıdaki hata yönetimi bölümü en yaygın dört HTTP yanıtını kapsar. Başka her şey için feedback@quire.io adresine e-posta gönderin.

İlgili: 5 Dakikada Quire MCP Kurulumu: Claude, ChatGPT veya Herhangi Bir AI İstemcisini Bağlayın — özel API çağrıları yazmak yerine bir AI istemcisinin doğrudan Quire ile çalışmasını istiyorsanız, MCP daha hızlı bir yoldur.

İlgili: Quire Ağ Kancalarını Kurmak İçin Adım Adım Bir Rehber — ağ kancaları, iş akışınızın API'yi sürekli sorgulamasına gerek kalmadan, Quire'da bir şey değiştiği anda güncellemeleri otomasyonunuza aktarır.

Sıkça Sorulan Sorular

Quire API nedir ve onunla neler yapabilirim?

Quire görevlerini programatik olarak okumak ve güncellemek için açık bir API'dir. Uygulama Dizini'ndeki mevcut bir uygulama uygun olmadığında özel entegrasyonlar oluşturmak için kullanın.

Quire API ile nasıl kimlik doğrularım?

Quire, OAuth2 kullanır. Bir Quire uygulaması kaydedin, istemci kimliğini ve sırrını alın, ardından kimlik bilgilerinin Quire'ın beklediği biçimde gönderilmesi için n8n authentication alanını Body olarak ayarlayın.

Quire ile entegrasyon için n8n kullanabilir miyim?

Evet. n8n'i ücretsiz olarak kendi sunucunuzda barındırın veya n8n.cloud'u kullanın, ardından görevleri okumak ve yazmak için OAuth2 kimlik bilgileriyle HTTP Request düğümlerini kullanın. Aynı yöntemler Zapier ve benzer platformlar için de geçerlidir.

Quire API'de sourceRef nedir?

sourceRef, bir görev üzerinde özel veri saklar. Önceden tanımlanmış text alanı Markdown'ı destekler ve görev detaylarında görüntülenir; kökeni takip etmek veya otomasyon meta verisi taşımak için meta gibi başka anahtarlar da ekleyebilirsiniz.

Quire API hata döndürdüğünde neyi kontrol etmeliyim?

401 token sorunlarını, 400 hatalı bir istek gövdesini, 403 izin sorunlarını ve 404 yanlış bir endpoint veya kimliği gösterir. Yanıt mesajını okuyun. Genellikle çözümü işaret eder.