WiozenAPI

WordPress eklentisini yapay zekâ API hesabına bağlarken çıkan hatalar nasıl çözülür?

Kısaca: Bağlantı birkaç adımlı bir el sıkışmadır: eklenti seni Wiozen'e gönderir, onay verirsin, site tek kullanımlık bir kodla geri döner ve eklenti bu kodu sunucudan sunucuya API anahtarına çevirir. Hatalar çoğunlukla bu dönüşte çıkar: kodun 5 dakikalık süresi dolar, WordPress oturumu dönüşte tanınmaz ya da site adresi https değildir. Wiozen İçerik Botu 1.5.10'dan beri oturum sorununu kendisi çözüyor; diğerlerinde bağlantıyı baştan başlatmak ya da anahtarı elle girmek yeter.

"Hesaba bağlan" düğmesi tam olarak ne yapıyor?

  1. Eklenti 32 karakterlik rastgele bir durum değeri ve 48 karakterlik gizli bir doğrulayıcı üretir, ikisini WordPress'te 15 dakika saklar.
  2. Seni account.wiozen.com'daki onay sayfasına gönderir. Adreste sitenin adresi, dönüş adresi, durum değeri ve doğrulayıcının SHA-256 özeti bulunur; doğrulayıcının kendisi bulunmaz.
  3. Wiozen'de giriş yaparsın ya da hesap açarsın. E-posta adresin doğrulanmış olmalı. Sayfada sitenin adı ve Anahtar oluştur ve bağlan düğmesi görünür.
  4. Onaylayınca tarayıcı sitene tek kullanımlık bir kodla döner. Kod 5 dakika geçerlidir.
  5. Eklenti kodu ve doğrulayıcıyı api.wiozen.com'a gönderir, karşılığında sk-gw- ile başlayan API anahtarını alır ve kaydeder. Panelde "Hesap bağlı" ve bakiyen görünür.

Anahtar hiçbir adımda adres çubuğundan geçmez. Biri dönüş adresindeki kodu ele geçirse bile doğrulayıcı yalnız senin sitende olduğu için kodu anahtara çeviremez. Anahtar API panelinin Anahtarlar sayfasında WordPress: alan-adın adıyla listelenir.

"Bağlantı isteği geçersiz" sayfası neden çıkıyor?

Bu sayfa onay ekranından önce, Wiozen tarafında çıkar. Hesap sitesi dönüş adresini kodu oraya göndermeden önce denetler, çünkü denetlemese onay sayfası kodu başka bir adrese taşımak için kullanılabilirdi. Dönüş adresi şu üç kuralı sağlamalı:

Gerçek sitelerde iki sebep öne çıkıyor. Birincisi sitenin hâlâ http üzerinde çalışması. İkincisi WordPress Ayarlar → Genel ekranındaki WordPress Adresi ile Site Adresi'nin farklı alan adları göstermesi: biri www'lu, öteki www'suz ya da WordPress ayrı bir alt alan adında. Eklenti site adresini birinden, dönüş adresini ötekinden aldığı için ikisi uyuşmaz. Siteyi https'e geçirmek ya da iki adresi aynı alan adına çekmek sorunu kaldırır. Bunu hemen yapamıyorsan anahtarı elle gir (aşağıda).

Onaydan sonra boş bir WordPress hata sayfası çıkıyor

Dönüş adresi WordPress'in yönetim tarafındadır ve orada oturum açmış olman gerekir. Oturum çerezi iki durumda dönüşte gelmez: oturumun bu arada kapanmışsa ya da sunucu çerezleri SameSite=Strict olarak yazıyorsa. Strict çerezi tarayıcı başka bir siteden gelen yönlendirmede göndermez; Wiozen'den sitene dönüş de böyle bir yönlendirmedir. 1.5.9 ve öncesinde WordPress bu durumda içi boş bir hata sayfası veriyordu.

1.5.10'dan beri eklenti oturumsuz gelen dönüşü yakalar. Önce kısa bir ara sayfa açar ve aynı adresi bu kez kendi sitenden yeniden ister; artık istek aynı siteden geldiği için çerez gönderilir. Oturum yine yoksa seni WordPress giriş sayfasına götürür ve giriş yaptıktan sonra bağlantı kaldığı yerden tamamlanır. Boş sayfa görüyorsan eklentiyi güncel sürüme (1.5.11) yükselt ve bağlantıyı baştan başlat.

"Bağlantı isteği bulunamadı ya da süresi doldu"

Bu uyarı eklentinin dönüşte kendi sakladığı isteği bulamadığını ya da dönen durum değerinin onunla eşleşmediğini söyler. Üç sık sebep var: düğmeye basıp onayı 15 dakikadan sonra verdin; bağlan düğmesine iki sekmede bastın ve eski sekmedeki onayı tamamladın (ikinci tıklama birincinin kaydını değiştirir); ya da bağlantı bir kez tamamlandıktan sonra aynı dönüş adresi yeniden açıldı. Çözüm, Hesaba bağlan'a bir kez basıp onayı birkaç dakika içinde vermek.

"Wiozen anahtarı vermedi"

Burada eklenti isteğini bulmuştur ama kodu anahtara çeviremez. Kod 5 dakikadan eskiyse ya da daha önce kullanılmışsa (kod tek kullanımlıktır; sayfayı yenilemek ya da geri dönmek onu ikinci kez gönderir) api.wiozen.com kodu reddeder. Sunucun api.wiozen.com'a dışarı doğru istek atamıyorsa da aynı uyarı çıkar; eklenti bu istek için 20 saniye bekler. Bazı barındırmalar dışa giden bağlantıları kısıtlar. Bir kez yeniden dene, tekrar ederse anahtarı elle gir.

Anahtarı elle nasıl girerim?

  1. API panelinin Anahtarlar sayfasında yeni bir anahtar oluştur ve kopyala.
  2. İçerik Botu'nun üstündeki bantta Anahtarı elle gir'i aç ya da Bağlantı ve otomasyon sekmesindeki API anahtarı alanını kullan.
  3. Anahtarı yapıştırıp kaydet. Alanı boş bırakıp kaydedersen kayıtlı anahtar korunur.

Kayıttan sonra bant "Hesap bağlı" ve bakiyeyi göstermeli. "Hesaba bağlanılamadı" görüyorsan ya anahtar yanlış kopyalanmıştır ya da sunucun Wiozen API'ye ulaşamıyordur; ikincisi yukarıdaki dışa giden bağlantı sorunudur.

"Bağlantıyı kes" anahtarı da siler mi?

Bağlantıyı kes anahtarı WordPress'ten siler ve zamanlanmış turları durdurur. Anahtarın kendisi Wiozen hesabında açık kalır; kapatmak için API panelinin Anahtarlar sayfasından iptal etmen gerekir.

Her başarılı bağlanma yeni bir anahtar oluşturur. Aynı siteyi birkaç kez bağladıysan Anahtarlar sayfasında birden çok WordPress: alan-adın satırı görürsün. Sitenin kullandığı en yenisidir; eskileri iptal etmek güvenlidir. Bir anahtarın başkasının eline geçtiğinden şüpheleniyorsan sızan anahtar rehberindeki adımları izle.

Sık sorulan sorular

Bağlanmak için Wiozen hesabı açmam gerekiyor mu?

Evet, ama ayrı bir adım değil. Onay sayfasında hesabın yoksa aynı akışta açarsın; e-posta adresini doğruladıktan sonra onay ekranı gelir.

Bağlantı kodu ne kadar geçerli?

Wiozen'in siteye verdiği kod 5 dakika ve tek kullanımlık. Eklentinin sakladığı bağlantı isteği 15 dakika yaşar.

Sitem http üzerinde, bağlanabilir miyim?

Tek tıkla bağlanma için dönüş adresi https olmalı. http sitede anahtarı API panelinden oluşturup elle girebilirsin.

Boş hata sayfası neden çıkıyor?

Dönüşte WordPress oturum çerezi gelmediği için. Genelde oturum kapanmıştır ya da çerezler SameSite=Strict yazılıyordur. Eklentinin 1.5.10 ve sonraki sürümleri bunu kendisi çözer.

Siteyi yeniden bağlarsam eski anahtar ne olur?

Açık kalır. Her bağlanma yeni bir anahtar oluşturur; eskilerini API panelinin Anahtarlar sayfasından iptal et.

Eklentiyi henüz kurmadıysan ürün sayfasından indir; kurulumun geri kalanı otomatik makale rehberinde.

Hesabını aç

Diğer rehberler: Türkiye'den kredi kartı olmadan yapay zekâ API'si nasıl kullanılır? · OpenAI uyumlu bir API mevcut bir araca nasıl bağlanır? · Yapay zekâ API maliyeti nasıl hesaplanır? · Yapay zekâ API anahtarım sızdıysa ne yapmalıyım? · Yapay zekâ API'siyle görsel nasıl üretilir ve görsel başı maliyeti ne kadar? · Yapay zekâ API'si neden 429 hatası veriyor, nasıl düzeltilir? · Uzun yanıt bekleyen API isteği neden zaman aşımına düşer: akışlı mı, akışsız mı? · Anthropic Messages API mı, OpenAI Chat Completions mı: hangisini kullanmalıyım? · Bağlam penceresi (context window) nedir, 1 milyon token ne işe yarar? · Hangi yapay zekâ modelini seçmeliyim: fiyat, bağlam ve kaliteye göre karar · Düşünen (reasoning) model neden boş cevap döner, düşünme tokenları neden ücretlenir? · API bakiyem neden beklediğimden hızlı bitiyor? Harcamayı istek istek takip etmek · Bir web sayfası yapay zekâya vermek için Markdown'a nasıl çevrilir? · WordPress'te yapay zekâyla otomatik makale nasıl yazdırılır? · Blog için RSS ve Google Trends'ten konu nasıl bulunur? · Yapay zekâyla yazılan içerik Google'da ve yapay zekâ yanıtlarında görünür mü? · WordPress'te yapay zekâyla yazılan makalelere iç bağlantı nasıl ekletilir? · WordPress'te her yazıya birbirine benzemeyen öne çıkan görsel yapay zekâyla nasıl ürettirilir? · Yapay zekâya blog yazısı yazdırırken içerik tarifi (brief) nasıl yazılır? · Yemek tarifi sitesine yapay zekâyla tarif yazdırırken nelere dikkat etmeli? · WordPress'te yapay zekâ yazı botu neden yarıda kalıyor? "Tur takıldı" uyarısı ve LiteSpeed · WordPress'te otomatik yazılar neden geç çıkıyor? WP-Cron ve gerçek sunucu cron'u · Yapay zekâ yazı botuyla İngilizce ya da başka dilde blog yazısı nasıl yazdırılır? · "İçerik Botu yazı üretemiyor" uyarısı ne demek? Bot günlüğündeki satırları okumak