REST API anahtarları ve imzalı webhook'lar (Pro)

Güncelleme: 19 Kas 2026 4 dakikalık okuma
Contix makalelerine göz atın

Contix Pro, kapsamlı REST API anahtarları ve imzalı webhook'lar sunar; böylece diğer sistemler Contix'te iş başlatabilir ve iş bittiğinde haberdar olabilir. İkisi de yalnızca bir yönetici bunları oluşturduktan sonra çalışır.

Nerede bulunur: ARN Contix → Sistem → Entegrasyonlar. Üst kısımda proje bağlamını seçin ve Entegrasyon çalışma alanını aç düğmesine tıklayın. Aynı ekrandaki Google Search Console bağlantısı Google Search Console ile performansı izleyin makalesinde anlatılmaktadır.

REST API kapsamları, Search Console bağlantısı ve imzalı webhook ayarlarını gösteren, hiçbir anahtarın görünmediği Contix Entegrasyonlar ekranı

REST API anahtarı oluşturun

  1. 1. REST API Anahtarları altında bir Ad girin.
  2. Proje bağlaması altında Tüm projeler seçeneğini veya tek bir projeyi seçin. Tek bir projeye bağlı anahtar yalnızca o projeyi (project_id) belirten isteklerle çalışır ve proje oluşturamaz. Bağlı bir anahtar GET /status çağrısını da yapabilir; GET /projects ise yalnızca kendi projesini döndürür.
  3. Anahtarın ihtiyaç duyduğu Kapsamlar seçeneklerini işaretleyin.
  4. API anahtarı oluştur düğmesine tıklayın.

Yeni anahtar yalnızca bir kez gösterilir: hemen kopyalayın ve güvenli bir yerde saklayın. Contix anahtarları yalnızca tuzlanmış hash olarak saklar ve bir anahtarı tekrar gösteremez.

Anahtar tablosunda Ad, anahtar Ön Ek, Kapsamlar ve anahtarın Son kullanım zamanı listelenir. Bir anahtarı durdurmak için İptal et düğmesine tıklayın; bu anahtarı kullanan istekler o andan itibaren reddedilir.

Kapsamlar ve uç noktalar

Tüm uç noktalar /wp-json/contix/v1/ altındadır. Anahtarı Authorization başlığında Bearer ve ardından anahtar olacak şekilde gönderin.

Yöntem ve uç noktaKapsamNe yapar
GET /statussystem.readContix sürümünü, şemayı ve çalışma ortamının duraklatılıp duraklatılmadığını döndürür
GET /projectsprojects.readProjeleri listeler; tek bir projeye bağlı anahtar için yalnızca o projeyi
POST /projectsprojects.writeBir proje oluşturur (name, language, region, brand_summary, content_goal)
GET /projects/{project_id}/topicstopics.readBir projenin konularını listeler
POST /projects/{project_id}/topicstopics.writeBir konu oluşturur (keyword, secondary_keywords, content_type, search_intent, audience, language, region, goal, priority)
POST /pipeline/startpipeline.writeBir çalıştırma başlatır (project_id, topic_id, automatic veya guided olarak mode)
GET /pipeline/{run_id}?project_id={project_id}pipeline.readBir çalıştırmanın durumunu döndürür
GET /projects/{project_id}/topics/{topic_id}/resultsresults.readBir konunun makale taslağı, analiz ve yayınlama paketi gibi kayıtlı sonuçlarını döndürür
GET /projects/{project_id}/jobsjobs.readBir projenin son işlerini listeler
GET /projects/{project_id}/connectorsconnectors.readBir projenin bağlayıcılarını listeler

Her anahtar dakikada 120 istekle sınırlıdır. Sık karşılaşılan yanıtlar:

DurumAnlamı
401Anahtar eksik, geçersiz veya iptal edilmiş
403Anahtar bu kapsamı vermiyor, başka bir projeye bağlı ya da projeye bağlı bir anahtar proje oluşturmaya çalıştı
409Çalıştırma başlatılamadı; nedeni mesajda belirtilir
422Proje veya konu oluşturulamadı; alanları kontrol edin
429Anahtar dakikada 120 istek sınırını aştı

Kimliği doğrulanmış her istek Contix günlüğüne kaydedilir.

İmzalı webhook oluşturma

  1. 3. İmzalı Webhook'lar altında bir Ad ve HTTPS uç noktası girin.
  2. İstediğiniz Olaylar seçeneklerini işaretleyin: job.completed, job.failed, pipeline.completed, pipeline.failed, publish.completed veya publish.failed.
  3. Webhook oluştur düğmesine tıklayın.

İmzalama sırrı yalnızca bir kez gösterilir: hemen kopyalayın. Yalnızca herkese açık HTTPS adresleri kabul edilir; özel ve ayrılmış ağ adresleri reddedilir.

Webhook tablosu olayları, başarılı ve başarısız teslimat sayısını ve son durumu gösterir. Bir webhook'u kaldırmak için Sil düğmesine tıklayın.

Webhook teslimatını doğrulama

Contix her olayı şu başlıklarla JSON POST olarak gönderir:

Başlıkİçerik
X-Contix-EventOlay türü, örneğin pipeline.completed
X-Contix-DeliverySabit bir teslimat kimliği; daha önce işlediğiniz bir teslimatı yok saymak için kullanın
X-Contix-TimestampTeslimat zamanı, Unix zaman damgası olarak
X-Contix-Signaturev1= ve ardından imza

İmza; zaman damgası, bir nokta ve ham istek gövdesinin (timestamp.body), anahtar olarak imzalama sırrınız kullanılarak hesaplanan onaltılık HMAC-SHA256 değeridir. İsteğe güvenmeden önce imzayı kendi tarafınızda hesaplayıp başlıkla karşılaştırın.

Uç noktanız 2xx durum koduyla yanıt verdiğinde teslimat başarılı sayılır. Ağ hataları ile 429 veya 5xx durumlu yanıtlar kuyruk üzerinden yeniden denenir. Yönlendirmeler izlenmez.

İlgili makaleler

Bu sayfada

Talep gönder

Portal hesabı açmadan yeni bir destek talebi oluşturun.

Öncelik
Ekler
Talebi yalnız siz ve ekibimiz görür. Şifre veya lisans kodu göndermeyin.

Talebi takip et

Onay e-postanızdaki talep numarası ve şifreyi kullanın.

Numara ve şifre onay e-postanızda.

Giriş

Destek portalı hesabınıza erişin.

Hesabınız yok mu?

Hesap oluştur

Destek portalı hesabınızı oluşturun.

Hesabınız var mı?

Şifremi unuttum

Yeni şifre seçmeniz için e-postanıza bir bağlantı gönderiyoruz.

Yazışma

İşinize yaradı mı?
Makalenin tamamını aç
↑ ↓ gezinirEnter açarEsc kapatır