Библиотека материаловИнтерфейсы библиотеки материалов
Руководство
Синхронизация статуса материалов
Обновление названий, статусов, сообщений об ошибках и адресов доступа групп и материалов для текущей учётной записи
Синхронизация статуса материалов
Синхронизация статуса материалов
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 | 素材服务暂不可用 | Сбой сервиса материалов; сохраните информацию о запросе и повторите попытку |
Эта страница была полезной?
