API belgeleri

Nordic Layers, https://app.layers.nordicbyte.co.uk adresinde HTTPS üzerinden çalışan bir REST API'sidir. Proje, katmanlardan oluşan bir JSON belgesidir; onu işlemlerle değiştirir ve görsel olarak dışa aktarırsınız. Tarayıcı editörü aynı API'yi kullanır.

Kimlik doğrulama

Hesap panelinizde bir API anahtarı oluşturun ve her /v1 isteğiyle birlikte gönderin. Anahtarlar nl_key_ ile başlar.

Authorization: Bearer nl_key_…

Olağan akış

1. Yükleyin: Her görseli POST /v1/assets ile, dosyayı ham istek gövdesi olarak gönderin (PNG, JPEG, WebP, GIF, BMP veya TIFF). Yanıt, görselin id değerini taşır.
2. Oluşturun: POST /v1/projects ile bir width, height ve background vererek proje oluşturun. İlk steps değerlerini aynı çağrıda da gönderebilirsiniz.
3. Düzenleyin: POST /v1/projects/{id}/run ile; tek işlem {"op": …}, birden çok işlem {"steps": [...]} biçiminde. Ücretsiz olan GET /v1/projects/{id}/preview ile sonucu görün.
4. Dışa aktarın: POST /v1/projects/{id}/export ile. Yanıt dosya URL'sini ya da "response": "image" ile görselin kendisini içerir.

İlk istek

Degradeli ve başlıklı 1080×1080 bir proje oluşturun, sonra WebP olarak dışa aktarın:

curl -X POST https://app.layers.nordicbyte.co.uk/v1/projects \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "First post",
    "width": 1080,
    "height": 1080,
    "steps": [
      {"op": "layer.addFill", "gradient": {"colors": ["#1E3A5F", "#64B5F6"], "angle": 135}},
      {"op": "text.add", "content": "Hello, layers", "fontName": "Segoe UI", "fontSize": 110, "bold": true, "color": "#FFFFFF"},
      {"op": "effects.set", "shadow": {"opacity": 0.4, "distance": 12, "size": 24}}
    ]
  }'

# → {"project": {"id": "…", …}}

curl -X POST https://app.layers.nordicbyte.co.uk/v1/projects/$PROJECT_ID/export \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "webp",
    "quality": 90
  }'

Uç noktalar

İşlemler

Her işlem, op ve parametrelerini içeren bir nesnedir. Katmanlara id veya adla başvurulur; layer verilmezse etkin katman kullanılır. Adlar büyük/küçük harfi ve boşlukları yok sayar; dolayısıyla "Linear Dodge (Add)" ile "linearDodge" aynı karışım modudur. steps ile işlemler sırayla çalışır ve ilk hatada durur ("stopOnError": false verilmedikçe); ondan önceki adımlar uygulanmış olarak kalır.

• Katmanlar
• Metin
• Şekiller
• Dönüştürme
• Bir katmanda ayarlamalar
• Filtreler
• Ayarlama katmanları
• Katman maskeleri
• Katman efektleri
• Tuval
• Proje

Katmanlar

Metin

Şekiller

Dönüştürme

Bir katmanda ayarlamalar

Filtreler

Ayarlama katmanları

Katman maskeleri

Katman efektleri

Tuval

Proje

Karışım modları

• normal
• darken
• multiply
• colorBurn
• linearBurn
• lighten
• screen
• colorDodge
• linearDodge
• overlay
• softLight
• hardLight
• difference
• exclusion
• subtract
• divide
• hue
• saturation
• color
• luminosity

Yazı tipi aileleri

• Arial
• Segoe UI
• Calibri
• Verdana
• Tahoma
• Trebuchet MS
• Georgia
• Times New Roman
• Courier New
• Consolas
• Impact
• Comic Sans MS

Şablonlar

Dışa aktarma çağrısına steps verin; bunlar yalnızca o dosya için projenin bir kopyasına uygulanır. Tek şablon, çok dosya: metni text.set ile, fotoğrafı katmanın kutusunu koruyan layer.setImage ile değiştirin.

curl -X POST https://app.layers.nordicbyte.co.uk/v1/projects/$TEMPLATE_ID/export \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "png",
    "steps": [
      {"op": "text.set", "layer": "Title", "content": "Nueva colección"},
      {"op": "layer.setImage", "layer": "Photo", "asset_id": "photo_dunes"}
    ]
  }'

Durumsuz render

POST /v1/render, tam bir document (project.document içinde döndürüldüğü gibi), isteğe bağlı steps ve dışa aktarma seçeneklerini alır ve proje kaydetmez. "response": "image" ile yanıt görsel dosyasıdır.

curl -X POST https://app.layers.nordicbyte.co.uk/v1/render \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document": {"width": 1200, "height": 630, "background": "#1E3A5F", "layers": ["…"]},
    "format": "png",
    "response": "image"
  }' \
  -o card.png

Hatalar

Hatalar, sabit bir code ve hesabınızın dilinde bir detail iletisiyle JSON olarak döner. Başarısız bir adım, hangi parametrenin yanlış olduğunu bildirir. Bir planın renderları bittiğinde API, quota_renders ile 402 yanıtı verir.

Sınırlar

• En fazla 50 MB ve kenar başına 12,000 px yükleme.
• Kenar başına en fazla 20,000 px tuval, planınızın megapiksel sınırı dahilinde.
• Çağrı başına en fazla 200 adım.
• Uzun kenarda en fazla 2,048 px önizleme.
• Megapiksel, katman, proje, depolama ve aylık render sayısı plana bağlıdır: Fiyatlar'a bakın.