/webadmin'deki tarayıcı yöneticisi ve Internal Content API, aynı CMS verilerine açılan iki ön kapıdır, ancak aynı anda oluşturulmamışlardır ve aynı zemini kapsamazlar. Panel tam operatör yüzeyidir. API, güvenilir yapay zeka ve operatör araçları için kasıtlı olarak daha dar bir yüzeydir.

Bu belge, ikisinin aynı fikirde olduğu, API'nin daha az kapsadığı ve boşluğun tamamlanmamış bir iş yerine kasıtlı bir sınır olduğu yerlerin yetkili haritasıdır. Şu şekilde var:

• an AI veya operatör aracı, denemeden önce neyi yapamayacağını bulabilir;
• a incelemecisi, eksik bir uç noktadan kasıtlı bir sınırı ayırt edebilir;
• Yol haritası çalışmasının kapatılacak tek bir listesi vardır.

Bu bir spesifikasyon değil, bir durum kaydıdır. Bir uç nokta gönderildiğinde, aynı taahhütte buradaki satırı güncelleyin.

Her satır bir durum taşır:

"Tasarım gereği yalnızca panel", "sert" ile eşanlamlı değildir. Bu, Internal Content API'nin Sınırlar bölümünde açıklanan güvenlik duruşunun hariç tutulduğu anlamına gelir: otomatik yayınlama yok, tarama veya uzaktan getirme yok, keyfi içe/dışa aktarma değişimi yok ve bir belirteç aracılığıyla ayrıcalık yükseltme yok.

API tek bir önek değildir. CMS ile entegre olan bir araç iki kişiyle konuşur:

Bölünme ilkesel olmaktan ziyade tarihseldir. /admin-api, yetenek modelinden öncesine dayanır ve domains.write ve domains.delete tanıtılana kadar rotaları, belirteç geçerliliğinin ötesinde hiçbir şeyi kontrol etmedi; herhangi bir geçerli belirteç, bir etki alanını ekleyebilir veya kaldırabilir. Etki alanı rotaları artık /webadmin/api altında da yaşıyor; yeni entegrasyonların işaret etmesi gereken yer burası; eski önek mevcut temel hazırlık araçları için çalışmaya devam eder.

Yetenekler CmsApiTokenCapabilities'de tanımlanmıştır. Bu belgedeki bir boşluk bazen eksik bir rota kadar eksik bir yetenektir.

Bu listeye hakim olan ikisi kapalı.

Sayfa kimliği ve sayfa çevirileri. create_draft_page, name, slug ve path'yi bir yerel ayar için bir sayfa çeviri satırına yazar ve Sayfa Çevirisi API'si gelene kadar daha sonra hiçbir şey bu satıra dokunamaz: değiştirme ve aşamalı güncelleme modları page'yi null'ye normalleştirir ve yalnızca yuva içeriğini işler. Yanlış yolda oluşturulan bir sayfa yalnızca silinip yeniden oluşturularak düzeltilebiliyordu, hiçbir sayfa ikinci bir yerel ayar kazanamıyordu ve hepsi o satırda yaşayan sayfa düzeyinde SEO (seo_title, seo_description, seo_keywords, og_title, og_description, og_image_media_id) geçerliydi. yazılamaz ve okuma yüklerinde de eksik.

/pages/{page}/translations/* artık bunların tamamını kapsıyor ve Page başlığı ve bilgi varsayılan çeviriye okunduğundan, bu çeviriyi yeniden adlandırmak sayfayı yeniden adlandırır. Bu alanların neden çeviri satırına ait olduğunu öğrenmek için Yerelleştirme'ye ve yazma sözleşmesi için Internal Content API'ye bakın.

Site düzeyindeki SEO varsayılanlarına ayrı bir nedenden dolayı hala erişilemiyor; aşağıdaki Sitelere bakın.

1.91.0'dan itibaren sekiz yerel medya bloğu, panelle aynı seçim ve geri dönüşle planlarda ve PATCH'te mobile_media_id'yi de açığa çıkarıyor. Bkz. Medya Görüntüsü Çeşitleri.

Bloklar CMS'nin en iyi hizalanmış alanıdır. Ayar yazma işlemleri ayrıca boşluk yerine koruma görevi gören BlockSettingsPatchPolicy tarafından da kısıtlanır.

Deletion, yıkıcı shared-slots.delete yeteneğini gerektirir ve hala referansta bulunan herhangi bir sayfa yuvasını Shared Slot kaldırmayı reddeder, referans yuvalarını listeler, böylece bir araç önce bunları ayırabilir.

POST /media/folders, aynı üst öğe altında zaten var olan bir adı reddeder ve mevcut klasörü döndürür; böylece yeniden deneme aracı, kopyaları yığmak yerine onu yeniden kullanır.

İletişim mesajlarının hiçbir API temsili yoktur. Bir araç, API aracılığıyla bir iletişim formu oluşturabilir ancak gönderimlerini okuyamaz veya bunların nereye teslim edildiğini öğrenemez; bkz. Sites.

Panel site formu yirmiden fazla alan yazar. API bunları dar tek amaçlı uç noktalar aracılığıyla kapsar: branding, head, timezone, public-theme, seo, contact-recipient ve locales.

Burada eksik kalan şey site kimliği (ad, tanıtıcı, birincil işaret) ve site değişkenleridir. Bunlar içerikten çok kaynak sağlamaya daha yakın ve henüz hiçbir araç onlara ihtiyaç duymadı.

Bu gruptaki her şey okunabilir ve hiçbiri yazılamaz.

Salt okunur şema erişimi savunulabilir: blok türleri ve düzenler yapısal sözleşmelerdir ve bunları bir belirtecin icat etmesine izin vermek, sonraki her içerik yazımının patlama yarıçapını genişletir. Böyle bir karar hiçbir yerde yazılmadığından, tasarımdan ziyade Kısmi olarak kaydedilmiştir.

Bu sorun düzeltilene kadar, bu belgedeki her boşluk arayan tarafından sessizdi.

POST /content/validate ve POST /content/apply, yasak anahtarlardan oluşan sabit bir listeyi (anahtarları yayınlama ve planlama, site oluşturma, uzaktan getirme ve yıkıcı fiiller) reddetti, ancak hiçbir şey tanınmadı. Plan normalleştirme, bildiği anahtarları okudu ve geri kalanını görmezden geldi, bu nedenle page.seo_title taşıyan bir plan, ok: true'yi ve hiçbirini yazmamış bir 201'yi döndürdü. Bir araç başarı bildirdi; hiçbir şey olmamıştı. Sayfayı geriye doğru okumak da bunu ortaya çıkarmadı çünkü API'nin yazamadığı alanlar aynı zamanda okuma veri yüklerinde de mevcut değil.

Tanınmayan anahtarlar artık 422 ve kararlı kod unsupported_plan_fields ile reddediliyor ve hata yolu, reddedilen her alanı adlandırıyor. Kabul edilen anahtar seti mode planının kapsamına alınmıştır: replace_slots bir sayfayı değiştirirken anlamlıdır ve bir sayfa oluştururken reddedilir.

Bu, aşağıdaki herhangi bir boşluğu kapatmaz. Bu, bir aracın hiç gerçekleşmemiş bir yazma işlemini raporlamak yerine panele geri dönebilmesinin ön koşulu olan, onları keşfedilebilir hale getirir.

Çabaya göre değil, her birinin engellemeyi kaldırma miktarına göre sıralanır.

Kademe 1 — tamamlandı

1. Tanınmayan plan anahtarlarını 422 ile reddedin. Yukarıdaki Bilinmeyen Plan Anahtarlarına bakın.
2. Sayfa çeviri yazma uç noktası. /pages/{page}/translations/* adı, bilgiyi, yolu, SEO ve Açık Grafiği yazar ve bunları geri okur.
3. Sayfa kimlik güncellemesi. 2 ile birlikte sunulur: başlık, bilgi ve yol çeviri alanlarıdır ve varsayılan yerel ayar çevirisi sayfanın kendi kimliğidir.
4. Shared Slot güncelleyin ve silin. PATCH ve DELETE /shared-slots/{sharedSlot}, yeni shared-slots.delete özelliğinin arkasında ikincisi.

Kademe 2 — tamamlandı

1. Extend site ayarları: SEO varsayılanları, contact_recipient_email, locale_ids. /sites/{site}/seo, /contact-recipient ve /locales.
2. Sayfanın ön izlemesini yapın veya anlık görüntüyü oluşturun. GET /pages/{page}/render, format=html ve yerel ayara göre işleme ile. Liste yazıldığında bunun kapsamı yanlış seçilmişti: /webadmin/pages/{page}/preview zaten bir Bearer jetonunu kabul etmişti, dolayısıyla aradaki fark, oluşturma yeteneğinden değil, keşfedilebilirlik ve yerel ayar seçiminden kaynaklanıyordu.
3. Medya klasörü oluşturma. GET/POST /media/folders.
4. Etki alanı rotalarını geçebilme yeteneği ve bunları /webadmin/api altına taşıyın. Bitti ve update ve set primary onunla birlikte geldi.

Geriye ne kaldı

Yukarıda hâlâ Eksik olarak işaretlenen her şey ikinci derecedendir: sayfa çoğaltma ve site taşıma, toplu işlemler, HTML'den bloğa dönüştürücü, yorum silme, kişi mesajları, şema yazma, arama yeniden dizini ve ziyaretçi raporları. Bunların hiçbiri bir aracın sayfa oluşturmasını, kontrol etmesini, düzeltmesini ve yayınlamasını engellemez; Katman 1 ve 2'nin konusu da budur. Listeyi incelemek yerine talebe göre seçim yapın.

Kademe 3 — kasıtlı sınırlar

Kullanıcılar, jeton verme, sistem ayarları, yedekleme geri yükleme/indirme, site oluşturma ve silme, klonlama, tanıtma ve aktarma yalnızca panelde kalma. Sistem güncellemeleri, 1.90.0'dan itibaren ayrı olarak verilen kurulum çapında API özellikleri aracılığıyla mevcuttur. "API'de olmaması"nın incelenmemiş bir devamsızlık yerine kayıtlı bir karar olması için burada listelenmiştir.

1.92.0'dan itibaren, panel ve API yükleme/güncelleme/etkinleştirme, gerekli eklenti veritabanı değişikliklerini otomatik olarak uygular ve arıza sonrasında devre dışı durumunu korur. Etkinleştirme/kurulum aynı uyumluluk kapısını kullanır; uyumsuz istekler HTTP 409 ve plugin_incompatible döndürür. 1.94.0'dan itibaren, başlangıç doğrulaması etkinleştirmeden önce yeni bir süreçte çalıştırılır, başarılı güncellemeler önceki paketi korur ve çalışma zamanı kaynak/rota hataları eklentiyi karantinaya alır.

/webadmin/plugin-recovery'deki kurtarma, kimliği doğrulanmış ayrı bir panel yüzeyidir. CMS 1.94.2, normal yönetici erişimine sahip etkin bir Super admin gerektirir. Arızalı bir yönetilen eklentiyi devre dışı bırakabilir veya tutulan paketi yalnızca veritabanı geçişi yapılmadığında geri yükleyebilir. /plugins/*'ye jeton erişimi bu tarayıcı kurtarma yetkisinin yerine geçmez. Bkz. Ekleme Sistemi.