同步素材狀態

POST/api/v1/materials/sync

驗證方式

Authorization: Bearer <API_KEY>。

請求內容 · application/json

無需欄位，可傳空物件 {}。

請求範例

curl -X POST "$LOCOPAL_BASE_URL/api/v1/materials/sync" \
  -H "Authorization: Bearer $LOCOPAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

回應參數

參數	類型	說明
`code`	integer	成功時為 `0`
`msg`	string	成功時為 `素材状态已同步`
`data.groups`	integer	本次重新整理到的分組數量
`data.adopted_groups`	integer	本次確認歸屬到目前帳號的分組數量
`data.assets`	integer	本次重新整理到的素材數量
`data.removed_assets`	integer	確認已失效並被移除的素材數量

回應內容

{
  "code": 0,
  "data": {
    "groups": 2,
    "adopted_groups": 0,
    "assets": 3,
    "removed_assets": 0
  },
  "msg": "素材状态已同步"
}

同步會依目前帳號自己的分組逐個讀取素材，重新整理名稱、狀態、錯誤資訊和素材位址。同步不會因為某一次查詢沒有傳回記錄就刪除素材，只有再次單獨查詢確認確實不存在時才會移除，因此重複執行同步是安全的。

錯誤回應

HTTP	msg	說明
`401`	`Invalid token`	API Key 缺少、錯誤或已失效
`502` / `503`	`素材服务暂不可用`	素材服務異常，保留請求資訊後重試

本頁目錄