Adım adım yayın anında sayfa geri bağlantı kontrolü
Bir webhook, bir HTTP çağrısı, bir karar. Bu çalıştırma kılavuzu, headless CMS ekibini hook, çağrılar ve hata durumları üzerinden yönlendirir.
Contentin araştırma ekibi ·
Kapının ne yapabileceğine karar verin
Sürüm akışı içindeki bir sayfa geri bağlantı kontrolü küçük bir iştir. Küçük tutun. Zor kısım, cevabın neyin değişmesine izin verileceğine karar vermektir; çünkü aylık olarak yenilenen bir bağlantı grafiği tek başına bir sayfayı reddedemez.
Kapının uyarı vermesini, log kaydı tutmasını ve derlemeyi devam ettirmesini öneriyoruz. Varsayılanlar değişebilir. Katı engeller, bozuk işaretleme veya eksik canonical etiketi gibi sizin kontrolünüzdeki şeylere aittir. Bağlantı verisi bir sinyaldir ve sinyaller kayar.
Bunu yazıya dökün. Kodlamadan önce bunu yapın. "Editöre uyarı ver, girişi etiketle, dağıtımı asla durdurma" gibi tek satırlık bir politika, sürüm gününde saat 18:00'de uzun bir tartışmayı önler. Ayrıca bir sonraki mühendise hangi hataların kastedildiğini ve hangilerinin hata olduğunu söyler; bu, göründüğünden daha önemlidir. Çeyrek yılda bir gözden geçirin.
Yayın tıklatma işleminden kaydedilen notaya kadar altı adım
1
Tetikleyiciyi seçin
CMS'inizdeki yayın olayına abone olun. Contentful, Sanity ve Strapi, bir içerik yayınlandığında size ait bir URL'yi çağırabilir; Storyblok ve Payload da webhook veya hook sunar. Dış bağlantı veya kanonik URL içeren içerik türlerine göre filtreleme yapın.
2
URL'yi bir etki alanına indirgeyin
API, q parametresiyle bir etki alanı alır; bu nedenle https://www.example.com/blog/post?x=1 önce example.com'a dönüştürülmelidir. www kullanımını bir kez belirleyin ve herhangi bir şeyi geliştirmeden önce ücretsiz domain eylemiyle gerçek bir etki alanını test edin.
3
Önce ücretsiz işlemi çağırın
overview ücretsizdir. Sonuç zayıf çıkarsa, alan adı yeni olabilir veya indeksimizde henüz bilinmiyor olabilir. Bu, kötü bir şeyin kanıtı değildir.
4
Kural tetiklendiğinde kredileri harcayın
Kuralınız daha dikkatli bakmanızı söylüyorsa, backlinks işlevini per=100 parametresiyle çağırın. Satır sayısı ne olursa olsun bu işlem 2 krediye mal olur, bu nedenle on küçük sayfa yerine anlamlı bir sayfa satırı isteyin.
5
Ham JSON yerine bir not yazın
Kendi alanınıza kısa bir değerlendirme ve kontrol tarihini kaydedin. Ham yanıtlar girişleri şişirir ve zamanla eskir, çünkü indeks her ay güncellenir.
6
Yumuşak hata verme
HTTP 401, anahtarın eksik veya yanlış olduğu anlamına gelir, bu nedenle bir insana uyarı verin. HTTP 402, kredinin bittiği anlamına gelir. Diğer tüm hatalarda: günlüğe kaydedin, kontrolü atlayın, yayınlamayı devam ettirin.
Anahtarın nerede olduğu ve 402'nin ne yapması gerektiği
Her ücretli çağrı, anahtarınızı sorgu dizisinde veya Bearer başlığında taşır. Başlığı tercih edin. Sorgu dizisi sunucu günlüklerine ve proxy izlerine karışabilir, ancak bir başlık genellikle bunların dışında kalır.
Anahtarı, girişin kendisinde değil, barındırma platformunuzda bir gizli değer olarak saklayın. Editörler erişebildikleri herhangi bir alanı okuyabilir, ancak bir işlevin ortamı genellikle yalnızca dağıtımları yöneten kişiler tarafından görülebilir.
Anahtar nerede olmalı?
Sızan bir anahtar hesabınızdaki bakiyeyi harcayabilir, bu nedenle onu bir parola gibi ele alın. Anahtarı depodan ve CMS'den uzak tutun, bir günlük dosyasında düz metin olarak görünürse anahtarı yenileyin.
Kendi günlüklerinizi, kancanın adıyla etiketleyin. Bu sayede, birden fazla kanka aynı hesabı paylaştığında bile harcama, tek bir işleve kolayca izlenebilir.
Kod yazmadan bir araç çağrı yapabilir mi?
Evet, araçta düz HTTP isteği adımı varsa. Birçok otomasyon oluşturucu, sorgu dizesiyle GET gönderebilir ve JSON'u geri okuyabilir, bu nedenle ücretsiz genel bakış eylemi için hiç kod gerekmez.
Yalnızca ücretsiz eylemlerle başlayın. Her tasarruf kaydında tetiklenen bir akış, bir editörün fark etmeden önce kredileri daha hızlı harcayabilir, bu nedenle ücretsiz çağrılar bir süre sessizce çalıştıktan sonra ücretli bir adım ekleyin.
Bir 402 hangi tetikleyiciyi oluşturmalı?
Bir 402, bakiyenin boş olduğunu gösterir. Sayfa hakkında hiçbir şey söylemez. Ücretli kontrolü atlayın, olayı günlüğe kaydedin ve hesabı yükleyen kişiye bir uyarı gönderin, ardından yayınlamayı devam ettirin.
Bakiye alarmını sıfırın oldukça üzerine ayarlayın, böylece uyarı, hala yükleme zamanı kalırken gelir. Bir yeniden deneme döngüsü burada yardımcı olmaz, çünkü her çağrı aynı şekilde başarısız olur, biri kredi ekleyene kadar. Maliyet tablosu sayıları içerir.
İki çağrıyı bir terminalden test edin
Kanca sizin için bunu yapmadan önce, bildiğiniz bir etki alanına karşı bunları bir kez çalıştırın. İkinci yanıtın _credits alanını okuyun.
bash
# free, no key
curl -s "https://contentin.app/api.php?action=overview&q=example.com"
# 2 credits, key in a header
curl -s -H "Authorization: Bearer sk_live_..." \
"https://contentin.app/api.php?action=backlinks&q=example.com&per=100"
q parametresine hangi etki alanı girilir
API, q'da çıplak bir etki alanı alır, bu nedenle tam bir URL'nin önce azaltılması gerekir. Bu azaltmayı bir işlevde bir kez yazın. Ardından gerçek URL'lerde test edin.
Bağılantılar ve eksik şemalar, genellikle bir kancayı bozan durumlardır. Temiz örneklerde çalışan bir azaltma, editörün 5'te yapıştırdığı dağınık URL'lerde hala başarısız olabilir.
www cevabı değiştiriyor mu?
Böyle olabilir ve bunu öğrenmenin dürüst yolu sormaktır. Bildiğiniz bir sitenin iki biçimini de kullanarak ücretsiz alan adı işlemini çalıştırın, ardından iki yanıtı yan yana karşılaştırın.
Hangi kuralı seçerseniz seçin, bunu bir kod yorumu olarak yazın ki sonraki mühendis tahmin etmek zorunda kalmasın. Bir yorumun maliyeti yoktur ve ileride uzun bir tartışmayı önler.
Yönlendirmeler ve alt alan adları hakkında ne düşünüyorsunuz?
Okuyucuların aslında eriştiği ana makineyi gönderin, editörün yıllar önce yapıştırdığı bağlantıyı değil. O bağlantı yönlendirme yapıyorsa, son adresi sadeleştirin ve aradaki sıçramayı yok sayın.
Kendi alt alan adında bir blog, bir yargı meselesidir. Önümüzde, bunun yalnız mı yoksa üst alan adıyla birlikte mi kontrol edileceğine karar verin ve bu seçimi kuralın yanına yazın.
Kanca için yayın öncesi kontrol listesi
Kanca yalnızca yayınlandığında çalışır, her tasarruf kaydında değil
URL, çağrıdan önce sade bir alan adına indirgenir
Ücretsiz işlemler önce çalışır ve krediler yalnızca bir bayrak durumunda harcanır
Bir 401 ve bir 402'nin her birinin kendi uyarısı ve kendi mesajı vardır
Bir zaman aşımı ayarlanır, böylece yavaş bir API editörü asla takılıp kalmaz
Depolanan not bir tarih taşır, böylece kimse onu canlı veri sanmaz
Aynı giriş iki kez yayınlanırsa iki kez faturalandırılmaz (bkz. mitos listesi)
Her atlanan kontrol için bir log satırı, oluşturabileceğiniz en ucuz denetim izidir. Giriş ID'sini, gönderdiğiniz alan adını, durum kodunu ve ücretli bir adımın çalışıp çalışmadığını kaydedin. Genellikle bu yeterlidir.
Depolanan not, yukarıdaki adımların belirttiği gibi kısa ve tarihli kalır. Tam yanıtlar kendi loglarınızda olmalıdır, eğer herhangi bir yerdeyseler, çünkü büyükler ve hızla eskirler.
Bir log satırında hangi alanlar yer almalı?
Giriş ID'si ve yayın sürümüyle başlayın. Tekrarlanan bir webhook, aynı çiftin iki kez görünmesine neden olur ki bu da görmek istediğiniz şeydir.
Alan adını, eylem adını, durum kodunu ve çağrının başladığı zamanı ekleyin. Anahtarı kendisini çıkarın, çünkü onu içeren bir log, sırların yaşadığı ikinci bir yer haline gelir.
Depolanan not ne kadar süre yaşayabilir?
Girişin ömrü boyunca, daha yeni bir kontrol onu yerine geçirene kadar. Önemli olan, bir okuyucunun notun ne kadar eski olduğunu ayırt edebilmesidir, çünkü aylar önceki bir not canlı veri gibi okunur.
Skor alanı rehberi, tarih dahil olmak üzere o not için önerdiğimiz dört alanı gösterir.
Kanca için yayından önce staj ortamında test yapın
Kancaya güvenmeden önce bu dört kontrolü çalıştırın.
1
Geçmiş bir yayını yeniden oynatın
Zaten yayınladığınız bir girişin bir kopyasıyla kancayı tetikleyin. Depolanan notu beklediğiniz şeyle karşılaştırın ve aynı girişin iki kez faturalandırılmadığını doğrulayın.
2
Yakında kaydedilmiş bir alan adı deneyin
Sizin için yeni olan bir ortak alan adı kullanın. Boş veya ince bir yanıt, başarısızlık olarak değil, bilinmeyen olarak depolanmalı ve not bunu açık sözlerle belirtmelidir.
3
Bilinçli olarak bir 402 zorlayın
Bakiyesini boşalttığınız bir test hesabındaki bir anahtarla kancayı çalıştırın. Atlama, log satırı ve uyarının hepsinin tetiklendiğini ve yayının yine de derlemeye ulaştığını doğrulayın.
4
Editörün gördüğü mesajı okuyun
Hata metnini okumak için ekibin dışından birine sorun. Eğer ne yapmaları gerektiğini söyleyemiyorlarsa, yayın gününden önce mesajı yeniden yazın. Sonraki analiz, belirsiz bir mesajın kurgusal bir ekibe neye mal olduğunu gösterir.
Kancanın göremeyecekleri
İndeksimiz ayda yaklaşık bir kez yenilenir. Son yenilemeden sonra eklenen bir bağlantı görünmez, ancak o tarihten beri kaldırılmış bir bağlantı hala görünebilir. Aynı gün kanıtı için Google Arama Konsolu'ndaki Bağlantılar raporunu kullanın.
