Nyaraka za API

Nordic Layers ni REST API kupitia HTTPS kwenye https://app.layers.nordicbyte.co.uk. Mradi ni hati ya JSON yenye tabaka; unaibadilisha kwa operesheni na kuisafirisha kama picha. Kihariri cha kivinjari kinatumia API ile ile.

Uthibitishaji

Tengeneza ufunguo wa API kwenye paneli ya akaunti yako na uutume kwa kila ombi la /v1. Funguo huanza na nl_key_.

Authorization: Bearer nl_key_…

Mtiririko wa kawaida

1. Pakia kila picha kwa POST /v1/assets ukiwa na faili kama mwili ghafi wa ombi (PNG, JPEG, WebP, GIF, BMP au TIFF). Jibu lina id yake.
2. Unda mradi kwa POST /v1/projects ukiwa na width, height na background. Unaweza kupitisha steps za kwanza katika wito huo huo.
3. Hariri kwa POST /v1/projects/{id}/run: operesheni moja kama {"op": …} au kadhaa kama {"steps": [...]}. Itazame kwa GET /v1/projects/{id}/preview, ambayo ni bure.
4. Safirisha kwa POST /v1/projects/{id}/export. Jibu lina URL ya faili, au picha yenyewe kwa "response": "image".

Ombi la kwanza

Unda mradi wa 1080×1080 wenye gredienti na kichwa, kisha uusafirishe kama WebP:

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
  }'

Sehemu za mwisho

Operesheni

Kila operesheni ni kitu chenye op na vigezo vyake. Tabaka hurejelewa kwa id au kwa jina; bila layer, tabaka linalotumika hutumiwa. Majina hayajali herufi kubwa au ndogo wala nafasi, kwa hiyo "Linear Dodge (Add)" na "linearDodge" ni modi ile ile ya kuchanganya. Kwa steps, hutekelezwa kwa mpangilio na kusimama kwenye kosa la kwanza (isipokuwa "stopOnError": false); hatua zilizotangulia hubaki zimetumika.

• Tabaka
• Maandishi
• Maumbo
• Kubadilisha umbo
• Marekebisho kwenye tabaka
• Vichujio
• Tabaka za marekebisho
• Barakoa za tabaka
• Athari za tabaka
• Turubai
• Mradi

Tabaka

Maandishi

Maumbo

Kubadilisha umbo

Marekebisho kwenye tabaka

Vichujio

Tabaka za marekebisho

Barakoa za tabaka

Athari za tabaka

Turubai

Mradi

Modi za kuchanganya

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

Familia za fonti

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

Violezo

Pitisha steps kwenye wito wa kusafirisha na zitatumika kwenye nakala ya mradi kwa faili hilo pekee. Kiolezo kimoja, faili nyingi: badilisha maandishi kwa text.set na picha kwa layer.setImage, ambayo huhifadhi kisanduku cha tabaka.

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"}
    ]
  }'

Render isiyo na hali

POST /v1/render inapokea document nzima (kama inavyorejeshwa katika project.document), steps za hiari na chaguo za usafirishaji, na haihifadhi mradi. Kwa "response": "image" jibu ni faili la picha.

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

Makosa

Makosa hurudi kama JSON yenye code thabiti na ujumbe wa detail katika lugha ya akaunti yako. Hatua inayoshindwa huripoti ni kigezo gani kilikuwa kibaya. Render za mpango zikiisha, API hujibu 402 pamoja na quota_renders.

Vikomo

• Upakiaji hadi 50 MB na 12,000 px kwa kila upande.
• Turubai hadi 20,000 px kwa kila upande, ndani ya megapikseli za mpango wako.
• Hadi hatua 200 kwa kila wito.
• Uhakiki hadi 2,048 px kwenye upande mrefu.
• Megapikseli, tabaka, miradi, hifadhi na render kwa mwezi hutegemea mpango: tazama Bei.