Bu rehberde: Webflow sitenizde bir site API token'ı üretip OrqLabs'a girersiniz. Yapay zekânın yazdığı makaleler CMS koleksiyonunuza (ör. Blog Posts) taslak öğe olarak eklenir; onaydan sonra öğeyi ya da tüm siteyi tek adımda yayınlarsınız.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | WEBFLOW |
| Kategori | CMS / web sitesi |
| Kimlik doğrulama | Site API token (Bearer, Data API v2) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Kutu | Webflow (app.webflow) |
Ne işe yarar?
| İşlem | Ne yapar | Etki |
|---|---|---|
| List collections | Sitenin CMS koleksiyonlarını (kimlik, ad, kısa ad) listeler; Include fields açıksa her koleksiyonun alanlarını (kısa ad, tür, zorunlu mu) da verir. | Okuma |
| Create item | Koleksiyona öğe ekler – varsayılan olarak taslak. | Değişiklik |
| Publish item | Bir veya daha fazla öğeyi canlı siteye yayınlar. | Yayın |
| Publish site | Sitedeki tüm hazır değişiklikleri yayınlar (özel alan adları ve/veya webflow.io). | Yayın |
Create item alan eşlemesi – koleksiyonun gerçek alanları okunur, ortak blog alanları otomatik yerleştirilir:
| Kutudaki alan | Webflow alanı |
|---|---|
| Name | name (zorunlu) |
| Slug | slug – boşsa addan üretilir (Yapay Zekâ Rehberi → yapay-zeka-rehberi) |
| Body | post-body, yoksa ilk Rich text alanı. Markdown verilirse HTML'e çevrilir |
| Summary | post-summary, yoksa adı summary / excerpt / description içeren ilk düz metin alanı |
| Main image URL + alt metin | main-image, yoksa ilk Image alanı; Webflow görseli adresten kendisi indirir |
| Field data (JSON) | Diğer tüm alanlar, kısa adlarıyla: {"featured": true, "category": "<öğe kimliği>"} – yukarıdakilerin üzerine yazar |
Alan türlerine göre değerler: Switch → true/false, Option → seçeneğin kimliği, Reference → öğe kimliği, Multi-reference → kimlik listesi, Date → ISO tarih, Link → adres.
Test çalıştırmalarında öğe oluşturma ve yayınlama çalıştırılmaz; List collections çalışır.
Ön koşullar
- Bir Webflow sitesi ve sitede CMS (CMS, Business veya üstü site planı; ücretsiz planda öğe sayısı sınırlıdır).
- Sitenin en az bir kez Designer'dan yayınlanmış olması (yayınlanmamış sitede öğe yayınlama başarısız olur).
- Site ayarlarına erişimi olan bir rol (token üretmek için).
Adım adım kurulum
A) Site API token
- Webflow Dashboard → sitenin ⋯ menüsü → Settings → Apps & integrations.
- API access bölümünde Generate API token.
- Ad:
OrqLabs; izinler:- CMS: Read and write
- Sites: Read and write (Publish site için gerekli)
- Generate token → token'ı kopyalayın; yalnızca bir kez gösterilir.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Webflow → Bağla → Proje seçin.
- Site API token alanına yapıştırın → Bağla. OrqLabs token'ın eriştiği siteyi okur.
Site token'ı tek siteye aittir; bu yüzden Site ID alanlarını boş bırakabilirsiniz.
C) Koleksiyon kimliğini bulma
Bir iş akışına Webflow → List collections kutusunu ekleyip Include fields açık olarak test çalıştırın. Çıktıdaki id Collection ID'dir; fields listesi Field data için kullanacağınız kısa adları gösterir. Kimliği Designer'da CMS → koleksiyon ayarları'ndan da kopyalayabilirsiniz.
Örnek iş akışları
1) SEO önerisinden Webflow taslağı
- Zamanlama – haftada bir.
- SEO ve Trafik ajanı (rehber) – içerik özetleri.
- Metin üret – Markdown makale →
text. - Görsel üret (isteğe bağlı) – kapak görseli →
{{ $json.imageUrl }}. - Webflow → Create item – Collection ID, Name
{{ $json.title }}, Body{{ $json.text }}, Main image URL{{ $json.imageUrl }}, Save as draft açık. - Ekibe bildir –
Webflow'da taslak öğe hazır: {{ $json.id }}.
2) Onaydan sonra yayınlama
… Create item → Onay iste → onaylandı → Webflow → Publish item (Collection ID aynı, Item IDs {{ $json.id }}).
Birden fazla öğeyi tek seferde canlıya almak veya sayfa değişiklikleriyle birlikte yayınlamak için Publish site kullanın.
Limitler
| Konu | Sınır |
|---|---|
| API hızı | Site planına göre dakikada 60–120 istek; aşılırsa RATE_LIMIT ve bekleme |
| Publish site | Dakikada en fazla 1 başarılı yayın |
| Görsel | Herkese açık adres, en fazla 4 MB |
| Rich text | Webflow API kod bloklarını desteklemez |
| Öğe sayısı | Site planınızın CMS öğe sınırı |
| Create item | Her çağrıda koleksiyon şeması okunur (1 ek istek) |
Bağlantıyı test etme
Bağlantıyı test et token'ın eriştiği siteleri ve alan adlarını gösterir.
Kimlik bilgilerini yenileme
Site ayarlarındaki API access listesinden eski token'ı silip yenisini üretin; OrqLabs'ta Kimlik bilgileri → Güncelle ile girin.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 | Token silinmiş veya yanlış | Yeni token girin |
FORBIDDEN – 403 missing_scopes | Token'da CMS veya Sites yazma izni yok | Token'ı doğru izinlerle yeniden üretin |
INVALID – "token can access N sites" | Çalışma alanı düzeyinde token kullanıldı | Site ID girin (hata mesajında listelenir) veya site token'ı kullanın |
INVALID – 400 validation_error (ör. fieldData.slug) | Kısa ad başka öğede kullanılıyor ya da zorunlu alan boş | Farklı Slug verin, zorunlu alanları Field data ile doldurun |
INVALID – "collection has no Rich text field" | Koleksiyonda gövde alanı yok | Değeri Field data ile doğru alana yazın |
RATE_LIMIT – 429 | Çok sık istek veya dakikada birden fazla site yayını | OrqLabs bekleyip yeniden dener; yayınları seyreltin |
Sık sorulan sorular
Öğe neden sitede görünmüyor? Create item öğeyi taslak (staged) oluşturur. Publish item veya Publish site çalışana kadar canlı sitede görünmez.
Kategori gibi referans alanlarını nasıl doldururum?
Field data içinde alanın kısa adıyla ilgili öğenin kimliğini verin, ör. {"category": "6501…"}. Kimlikleri Webflow'daki referans koleksiyonundan alırsınız.
Mevcut öğeyi güncelleyebilir miyim? Şu an yalnızca yeni öğe eklenir; mevcut öğeyi Webflow'da düzenleyin.