Sorun Giderme ve SSS
CopyPatch v3 entegrasyonlarında karşılaşabileceğiniz yapılandırma, rota yönlendirme, yetkilendirme ve veritabanı durumlarını hızla teşhis edin.
1. CLI ile Hızlı Teşhis
Üretilen yapılandırmayı ve gerekli CopyPatch ortam değişkenlerini incelemenin en hızlı yolu doctor komutudur:
# Çalışma zamanı teşhis komutunu çalıştırın
npx copypatch doctor2. Hata Kodları Başvuru Tablosu
| Hata Kodu | HTTP Durumu | Olası Neden | Çözüm Adımı |
|---|---|---|---|
VALIDATION_ERROR | 400 | İstek gövdesi, locale, içerik anahtarı veya metin doğrulamayı geçemedi. | İstek biçimini düzeltin ve yapılandırılmış metin sınırına uyun. |
UNAUTHENTICATED | 401 / 403 | Kimlik doğrulaması eksik veya principal gerekli role sahip değil. | Yeniden giriş yapın; adaptördeki editor ve publisher rol eşlemesini denetleyin. |
CSRF_FAILED | 403 | CSRF belirteci veya host mutasyon doğrulaması başarısız oldu. | Oturumu yenileyin; özel adaptör verifyMutation metodundan açıkça true döndürmelidir. |
ORIGIN_REJECTED | 403 | İsteğin Origin değeri URL origin’iyle tam eşleşmiyor. | Same-origin API rotasını ve host trusted-proxy politikasını denetleyin. |
RATE_LIMITED | 429 | İstemci anahtarının unsafe istek sınırı aşıldı. | Retry penceresini bekleyin ve istemcilerin ayrı güvenilir adresler aldığını doğrulayın. |
CLIENT_ADDRESS_UNAVAILABLE | 503 | Next.js unsafe isteğinde güvenilir istemci adresi yok. | Deployment platformundan adres çözümleyin veya paylaşımlı bucket’ı açıkça seçin. |
REVISION_CONFLICT | 409 | Başka bir editör published veya draft revizyonunu değiştirdi. | Editor snapshot’ını yeniden yükleyip değişikliği tekrar uygulayın. |
UNSUPPORTED_OPERATION | 405 | Endpoint kullanılan HTTP metodunu desteklemiyor. | Endpoint için belgelenen metodu kullanın. |
INTERNAL_ERROR | 500 | Backend isteği tamamlayamadı. | İç ayrıntıları istemciye açmadan sunucu loglarını ve depolama sağlığını inceleyin. |
NOT_FOUND | 404 | İstenen CopyPatch endpoint’i yok. | Canonical /__copypatch/api/v2 mount’unu ve rota son ekini doğrulayın. |
3. Sık Karşılaşılan Durumlar ve Çözümleri
Düzenleme Araç Çubuğu Görünmüyor
- URL sorgu parametresinin tam olarak
?copypatch=1olduğunu teyit edin. CopyPatchProvidersağlayıcısının ilgili bileşen ağacını kapsadığından emin olun.- Tembel yükleme sırasında bir hata oluşup oluşmadığını tarayıcınızın Geliştirici Araçları (Console) sekmesinden denetleyin.
Rota 404 Not Found Hatası Veriyor
- Sunucunuzun API rotasını tam olarak
/__copypatch/api/v2adresine mount ettiğini doğrulayın. - Next.js App Router kullanıyorsanız klasör adının yüzde kodlamalı olduğundan emin olun:
app/%5F%5Fcopypatch/api/v2/[…path]/route.ts. - Express kullanıyorsanız
app.use(‘/__copypatch/api/v2’, expressMiddleware(backend))tanımınınexpress.json()ve SPA fallback’lerinden önce yer aldığını kontrol edin.
4. Sıkça Sorulan Sorular (SSS)
CopyPatch içinde zengin metin (Rich-text / HTML) kullanabilir miyim?
Hayır. CopyPatch bilinçli olarak katı bir düz metin (plain-text) ilkesi uygular. HTML girişine izin vermek hem depolanmış XSS güvenlik riskleri yaratır hem de teknik bilgisi olmayan editörlerin sitenizin CSS ve mobil yerleşimini bozmasına neden olur.
CopyPatch’i tamamen statik bir CDN sitesinde (örn. GitHub Pages) çalıştırabilir miyim?
Statik çıktılar varsayılan yedek metinleri render edebilir; ancak salt statik bir barındırmada canlı düzenleme veya kaydetme yapılamaz. Güvenli mutasyonları işlemek ve veritabanına yazmak için Node.js, sunucusuz (serverless) veya konteyner tabanlı aktif bir sunucu çalışma zamanı gereklidir.