DEV Mockup API · Webhook · Dropship · Order Status

Developers
Tech-driven B2B

PersonTees 公開 5 個 REST API endpoint · Mockup 即時生成 · Webhook 即時推送 · Closet Auth 多角色 · Dropship CSV 多地址配送。

REF · API-2026Q4 5 endpoints Webhook ready

5 個 REST API Endpoint

1. Mockup API Beta

POST /api/mockup/generate

由 design PNG + garment SKU 即場生成 mockup 圖 · 5 秒回應 · 返回 mockup URL

POST https://persontees-pod-library.persontees.workers.dev/api/mockup/generate
Headers: Authorization: Bearer YOUR_API_KEY
{
  "garment_sku": "TSHIRT-COTTON-180GSM-WHITE-M",
  "design_url": "https://example.com/logo.png",
  "placement": "front_center",
  "size_cm": 25
}
→ 200 OK
{
  "mockup_url": "https://r2.persontees.com/mockups/abc123.png",
  "expires_at": "2026-10-14T12:00:00Z"
}

2. Order Status Webhook Stable

POST {your_url}

每張訂單 stage 變更時推送 webhook · 5 個 stage: brief → samples → bulk → QC → shipped

POST your_webhook_url
Headers: X-Persontees-Signature: sha256=...
{
  "order_id": "ASE-003",
  "stage": "qc_shipped",
  "updated_at": "2026-10-07T15:30:00Z",
  "tracking_no": "DHL1234567890",
  "qc_report_url": "https://r2.persontees.com/qc/ASE-003.pdf"
}

3. Closet Auth Stable

POST /api/closet/login

員工 / 客戶 multi-role login · sessionStorage + JWT token · 30 天 TTL

POST https://persontees-pod-library.persontees.workers.dev/api/closet/login
{
  "email": "user@company.com",
  "password": "..."
}
→ 200 OK
{
  "ok": true,
  "email": "user@company.com",
  "role": "marketing_manager",
  "client_id": "asendia",
  "redirect": "/closet/orders/asendia/"
}

4. Dropship CSV Import Stable

POST /api/dropship/import

CSV 多地址批量 import · 1000 個地址 / 5 分鐘 · 自動拆單 + 追蹤號回傳

POST https://persontees-pod-library.persontees.workers.dev/api/dropship/import
Content-Type: multipart/form-data
{
  "order_id": "ORD-2026-100",
  "csv_file": "[binary CSV]",
  "per_address_packaging": true
}
→ 200 OK
{
  "ok": true,
  "imported_count": 847,
  "tracking_numbers": ["DHL1...", "DHL2..."]
}

5. Pantone Dropping Upload Beta

POST /api/pantone/verify

Pantone 鎖色認證 · ΔE ≤ 2 光譜儀度數 · 返回認證書 PDF

POST https://persontees-pod-library.persontees.workers.dev/api/pantone/verify
{
  "design_pantone": "Pantone 286 C",
  "fabric_color_hex": "#FFFFFF",
  "craft": "silkscreen"
}
→ 200 OK
{
  "ok": true,
  "delta_e": 1.8,
  "certification_pdf_url": "https://r2.persontees.com/cert/pantone-286.pdf"
}

申請 API Key

填 email + 公司名 + 預計使用場景 · 我哋 24 小時內 send API key 俾你 · 免費 tier = 1000 calls / 月

DevelopersTech-driven B2B