2 週內更新 API
114年5月7日, 上午 10:00
兩週後，即 5 月 24 日的週末，我們將實施全新的 EasyWebshop API。對於技術背景較少的用戶：此 API 可將您的網路商店與外部平台（如支付服務供應商、送貨服務及辦公室應用程式）連接起來。此 API 亦可讓您建立自訂報告、即時接受或拒絕客戶，以及將銷售和庫存與本地應用程式同步。
由於與通用實踐和行業標準兼容，建立新的 API 連接將變得更加容易，甚至可能借助 AI 生成的程式碼。這為希望自行建立自訂連接的小型企業消除了主要的財務障礙。
在我們第三次舉辦的網頁設計之夏活動期間（從 2025 年 6 月 21 日開始），您仍可聘請經驗豐富的網頁開發人員。
API 變更
如果您目前正在使用此 API，則需要對您的連接進行少量更新。如果您未使用此 API，則可以略過此技術性說明部分。
- 使用權杖進行驗證
- 新 API 實施後，建議您在 API 設定中建立權杖、設定權限，並將授權標頭 (Authorization header) 方法從「基本」(Basic) 更改為「持有者權杖」(Bearer YOUR_API_TOKEN)。使用管理員帳戶的基本驗證 (Basic authentication) 仍可繼續運作，但將於今年年底前逐步淘汰。將不再支援使用主帳戶的電子郵件地址和密碼進行驗證。
- 預設為 JSON 格式
- 目前的 API 於 2012 年推出時，選擇了 XML 作為預設格式。新的 API 將預設使用 JSON，但您仍可透過在 URL 中新增 "?format=xml" 查詢字串來切換至 XML 格式。
- 與標準 JSON-LD 結構描述的兼容性
- 產品資料將盡可能遵循 schema.org/Product 標準。最重要的變更為 "product_code" 將更改為 "productID"。訂單資料將遵循 schema.org/Order 標準。此處最重要的變更為 "order_code" 將更改為 "orderNumber"。
- 簡化的 API 端點
- 諸如 "productlist" 之類的端點將不再有效。四個有效的端點為："category"、"product"、"customer" 和 "order"。
- 上傳產品照片
- 將不再有獨立的上傳照片方法。我們已簡化此流程，現在可以在新增和更新產品時附加照片。
- 類別名稱、產品名稱和描述
- 即便網路商店中尚未啟用某些語言，您仍可以所有支援的語言來新增及更新類別名稱、產品名稱與描述。
- API Push 的結構將略有不同
- API Push 用於即時傳送客戶和訂單資訊。其結構將與 schema.org/Person 和 schema.org/Order 有更好的兼容性。
- API 連接建立文件更完善
- 連接支付服務供應商、送貨服務和辦公室應用程式將變得更加容易。新文件將提供詳盡的範例，助您快速設定此類連接。
新的 API 將在 API 文件頁面上提供全部 20 種語言的完整文件。在實施期間的週末，我們的支援服務團隊將隨時待命，以迅速協助您對現有實施進行更改。