Skip to main content
Ön Koşul: Lütfen devam etmeden önce Node.js’in güncel bir sürümünün (v18 veya üstü) yüklü olduğundan emin olun.
Crafter projenizi yerel makinenizde çalıştırmak ve geliştirmek için bu adımları izleyin. Adım 1: Proje klasörünüze gidin (.env.local dosyasının bulunduğu yer) ve aşağıdaki komutu çalıştırın:
Yerel geliştirme sunucusu başlatıldığında, web sitenizin bir önizlemesi http://localhost:3000 adresinde erişilebilir olacaktır.

Özel Port Kullanımı

Varsayılan olarak, Next.js 3000 portunu kullanır. Farklı bir port kullanmak için --port bayrağını ekleyebilirsiniz. Örneğin, projeyi 3333 portunda çalıştırmak için şu komutu kullanın:
Eğer belirlediğiniz port kullanımda ise, sistem otomatik olarak bir sonraki uygun portu deneyecektir.

API Entegrasyonu ve Geliştirme

Crafter, sunucu verilerinizi yönetmek ve özel entegrasyonlar oluşturmak için güçlü bir API sunar. Tüm API endpoint’lerini ve modellerini Swagger arayüzü üzerinden inceleyebilirsiniz.

Detaylı API Dokümantasyonu

Tüm API endpoint’lerini, gerekli parametreleri ve yanıt modellerini görmek için Swagger arayüzünü ziyaret edin.

Önemli: Origin Header Zorunluluğu

Güvenlik nedeniyle, Crafter API’sine gönderilen tüm isteklerde Origin başlığının (header) bulunması zorunludur. Bu başlığın değeri, isteği yapan web sitesinin adresi olmalıdır. Aksi takdirde, isteğiniz API tarafından reddedilecektir.
API’ye istek gönderirken Origin başlığına, Crafter Yönetim Paneli’nde kayıtlı olan website_url değerinizi eklemeyi unutmayın.

Örnek 1: Site Bilgilerini Çekme

Aşağıda GET metodu ile site yapılandırma bilgilerini çeken örnek bir API isteği görebilirsiniz:

Örnek 2: Lisans Anahtarı Doğrulama

Aşağıda POST metodu ile lisans anahtarının geçerliliğini kontrol eden örnek bir API isteği görebilirsiniz. Bu endpoint, swagger üzerinden de görüldüğü gibi, gönderilen anahtarın doğruluğunu teyit eder.

Sorun Giderme

Bu durum genellikle eksik veya eski paketlerden kaynaklanır. Aşağıdaki adımları deneyin:
  1. node_modules klasörünü ve package-lock.json dosyasını silin.
  2. Node.js sürümünüzün güncel olduğundan emin olun (v18+).
  3. Paketleri yeniden yükleyin: npm install
  4. Projeyi tekrar başlatın: npm run dev
Bu hata, isteğinizdeki Origin başlığının eksik veya yanlış olduğunu gösterir.
  • İsteğinizin headers bölümünde Origin başlığının bulunduğundan emin olun.
  • Origin başlığının değerinin, Crafter panelinde kayıtlı olan site adresinizle birebir aynı olduğunu kontrol edin.