API/Webhook + AymarTech

AI ile üretilen makaleleri imzalı webhook teslimleriyle kendi endpoint’inize otomatik ya da onaydan sonra gönderin.

API/Webhook özel web siteleri ve desteklenmeyen CMS yığınları içindir. Siteniz onaylanan veya otomatik yayınlanan makaleleri bir API anahtarıyla AymarTech’ten çekebilir ve makale durumu değişince webhook bildirimleri alabilir.

Sorunlar

SEO yayını neden sürekli takılıyor

Çoğu ekip fikir eksikliğinden değil, her makale yayına çıkmadan önce çok fazla küçük manuel karar gerektirdiği için zorlanır.

Konu seçimi tahmine dönüşür

Keyword talebi, arama niyeti ve iş önceliği farklı sekmelere dağılır; sıradaki makale kanıt yerine fikre göre seçilir.

Her makale operasyon kontrol listesine dönüşür

Brief, taslak, görsel, metadata, iç link ve QA adımları araçlar arasında gidip gelir; süreç yavaş ve tutarsız hale gelir.

Yayınlama son adımda kilitlenir

Hazır taslaklar slug, formatlama, platform alanları ve her şeyi yayına alacak zamanı olan birini bekler.

Ne kazanırsınız

Gerçek arama talebinden indekslemeye hazır makalelere

İnsanların gerçekten aradığı anahtar kelimeler

AymarTech gerçek talebi, net arama niyeti ve nitelikli trafik getirme şansı olan arama sorgularını bulur.

Birçok kaynaktan derin araştırma

Her makale geniş kaynak araştırmasıyla hazırlanır; taslak yüzeysel dolgu metin yerine konuyu gerçekten kapsar.

Google dostu yayınlama

Temiz yapı, metadata, slug, iç linkler ve doğrudan yayınlama Google'ın yeni makaleleri daha hızlı keşfetmesine ve indekslemesine yardımcı olur.

İçerik akışı

Anahtar kelimeden hazır makaleye

Talebi bul

AymarTech müşterilerinizin zaten aradığı düşük rekabetli konuları belirler.

Yaz ve optimize et

Makale yazılır, doğrulanır, formatlanır, görsellerle zenginleştirilir ve SEO detaylarıyla hazırlanır.

Endpoint'e teslim et

AymarTech makaleyi Publishing API ve webhook event’leri için hazırlar; ardından otomatik teslim eder ya da onay bekler.

Kimler için

Kod tabanını kontrol ettiğinizde, özel render istediğinizde veya AymarTech’in backend’inizi otomatik teslimat ya da makale verisi açılmadan önce onay ile bilgilendirmesini istediğinizde bunu kullanın.

Neler yayınlanır veya teslim edilir

Yük AymarTech yayınlanan makaleleri Publishing API üzerinden açar ve article_published, article_updated ile article_unpublished webhook’ları gönderebilir. Webhook yükleri event, article id, slug, headline, yayın durumu ve updatedAt içerir; API makale yanıtları render için makale içeriği ve meta veri içerir.

Kurulum

Tüm bağlantı formları, OAuth butonları, hedef seçiciler, yayın modu ayarları ve test işlemleri AymarTech panelindedir. Yayına çıkmadan önce otomatik yayınlama ya da onay isteme modunu seçin.

Panel entegrasyonlarını aç →

AymarTech’te projeyi açın ve panelde publishing/API ayarlarına gidin.
Proje için bir API anahtarı oluşturun.
Web sitesi ortamınızda BLOG_WRITER_BASE_URL’i projenin publish API taban URL’sine ve BLOG_WRITER_API_KEY’i üretilen anahtara ayarlayın.
Makale listeleri için GET /articles, makale sayfaları için GET /articles?slug=... ve dinamik sitemap için GET /sitemap kullanın.
Makale verisi açılmadan önce otomatik teslimat veya onay seçin; isteğe bağlı olarak önbellek yeniden doğrulama veya alt iş akışları için bir webhook URL’si ve secret ekleyin.
Panelden test webhook’u gönderin ve endpoint’inizin 2xx yanıt döndürdüğünü doğrulayın.

Makale yayını veya teslimi nasıl çalışır

Publishing API yalnızca API anahtarıyla ilişkili proje için onaylanan veya otomatik yayınlanan makale verisini döndürür.
Webhook’lar onay veya otomatik yayından sonra article_published, article_updated ve article_unpublished olaylarında gönderilir.
Bir webhook secret yapılandırılmışsa AymarTech hem X-Webhook-Signature hem X-Webhook-Secret başlıklarını gönderir.
Webhook imzaları JSON yük gövdesi üzerinde HMAC-SHA256’dır.
HTML, SEO meta verisi, kanonik URL’ler, hreflang ve önbellek geçersizleştirme sitenizin sorumluluğunda kalır.

Sorun giderme

Publishing API’den 401: API anahtarının X-API-Key veya Authorization: Bearer içinde olduğunu doğrulayın.
Makale dönmüyor: makalelerin AymarTech’te onaylandığını veya otomatik yayınlandığını ve proje ID/taban URL’nin doğru olduğunu doğrulayın.
Webhook imza uyuşmazlığı: sunucunuzun kayıtlı secret ile tam ham JSON gövdesi üzerinde HMAC hesapladığını doğrulayın.
Webhook zaman aşımı: hızla 2xx ile onaylayın ve ağır işlemeyi bir kuyruğa taşıyın.
Sitemap bayat: dinamik üretin veya article_published webhook’ları gelince yeniden doğrulayın.

Sık sorulanlar

API/Webhook teslimatı otomatik olabilir mi?

Evet. Modu siz seçersiniz: hazır olduğunda makale verisini otomatik teslim edin veya açın, ya da önce onay isteyin. Web siteniz veya backend’iniz içeriğin nasıl render edileceğine veya saklanacağına hâlâ karar verir.

Hangi endpoint’lere ihtiyacım var?

Çoğu site listeler için /articles, detay sayfaları için /articles?slug=... ve SEO keşfi için /sitemap kullanır.

Webhook zorunlu mu?

Hayır. İsteğe bağlıdır; ancak önbellek yeniden doğrulama ve alt iş akışları için yararlıdır.

Webhook’ları nasıl doğrulamalıyım?

Paylaşılan secret ile X-Webhook-Signature kullanın. Daha basit doğrulama için yapılandırıldığında X-Webhook-Secret da gönderilir.

Tam API değerleri nerede?

Panel proje API anahtarını, publish API taban URL’sini, webhook URL alanını, secret alanını ve test işlemlerini gösterir.

İlgili

Notion Shopify WordPress.org Tüm entegrasyonları gör

SEO makale teslimini kontrol edin

Ücretsiz başlayın, endpoint’inizi bağlayın ve optimize makaleler backend’inize ulaşmadan önce otomatik teslim ya da onay modunu seçin.

Ücretsiz Dene