Перейти к основному содержанию
LocoPal AiLocoPal Ai
Библиотека материаловИнтерфейсы библиотеки материалов

Руководство

Синхронизация статуса материалов

Обновление названий, статусов, сообщений об ошибках и адресов доступа групп и материалов для текущей учётной записи

Показать Markdown

Синхронизация статуса материалов

Синхронизация статуса материалов

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 '{}'

Параметры ответа

ПараметрТипОписание
codeintegerПри успехе — 0
msgstringПри успехе — 素材状态已同步
data.groupsintegerКоличество групп, обновлённых в этот раз
data.adopted_groupsintegerКоличество групп, принадлежность которых текущей учётной записи подтверждена в этот раз
data.assetsintegerКоличество материалов, обновлённых в этот раз
data.removed_assetsintegerКоличество материалов, подтверждённых как недействительные и удалённых

Тело ответа

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

Синхронизация последовательно читает материалы по собственным группам текущей учётной записи и обновляет названия, статусы, сообщения об ошибках и адреса материалов. Синхронизация не удаляет материал только потому, что один запрос не вернул запись: удаление происходит только после отдельного повторного запроса, подтверждающего, что материала действительно нет, поэтому повторное выполнение синхронизации безопасно.

Ответы с ошибками

HTTPmsgОписание
401Invalid tokenAPI Key отсутствует, неверен или истёк
502 / 503素材服务暂不可用Сбой сервиса материалов; сохраните информацию о запросе и повторите попытку
Эта страница была полезной?

На этой странице