Dist CDN

فایل‌ها را با نسخه روی کیاشو آپلود کن، از هاست‌های دیگه با یک لینک عمومی دانلود کن — بدون FTP ضعیف و قطع‌شونده.

خلاصه

توکن را از پروفایل بساز
با curl آپلود کن (slug + version + فایل)
روی هاست با wget/curl از لینک عمومی بکش

۱) ساخت توکنلاگین

وارد کیاشو شو → پروفایل → کارت Dist CDN → «ساخت توکن». توکن کامل فقط یک‌بار نشان داده می‌شود؛ ذخیره کن.

Authorization: Bearer kd_xxxxxxxx...

۲) آپلود نسخهBearer

حتماً slug و version را در query بگذار (قبل از فایل).

curl -X POST "https://app.kiasho.ir/api/dist/v1/upload?slug=mysite&version=1.2.0" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@./site.zip"

پاسخ شامل downloadUrl و latestUrl است.

۳) دانلود عمومیبدون توکن

# نسخه مشخص
curl -fsSL -o site.zip \
  "https://app.kiasho.ir/dist/USERNAME/mysite/1.2.0"

# همیشه آخرین نسخه
curl -fsSL -o site.zip \
  "https://app.kiasho.ir/dist/USERNAME/mysite/latest"

روی هاست اشتراکی هم همین لینک‌ها با wget کار می‌کنند.

۴) لیست نسخه‌ها

curl -fsS "https://app.kiasho.ir/api/dist/v1/USERNAME/mysite"

۵) متادیتا یک نسخه

curl -fsS "https://app.kiasho.ir/api/dist/v1/USERNAME/mysite/1.2.0"
curl -fsS "https://app.kiasho.ir/api/dist/v1/USERNAME/mysite/latest"

۶) حذف یک نسخهBearer

curl -X DELETE "https://app.kiasho.ir/api/dist/v1/mysite/1.2.0" \
  -H "Authorization: Bearer YOUR_TOKEN"

قواعد نام‌گذاری

slug و version: فقط حروف، عدد، . _ - (حداکثر ۶۴)
نسخه نمی‌تواند latest باشد (رزرو برای آخرین آپلود)
آپلود دوباره همان slug+version جایگزین می‌شود

اسکریپت نمونه روی هاست

#!/bin/bash
set -euo pipefail
URL="https://app.kiasho.ir/dist/USERNAME/mysite/latest"
TMP=$(mktemp)
curl -fsSL -o "$TMP" "$URL"
# unzip / rsync به مسیر سایت خودت
# unzip -o "$TMP" -d /home/user/public_html
rm -f "$TMP"
echo OK

API پایه: /api/dist/v1 · دانلود: /dist/{username}/{slug}/{version}