Synchroniser le statut des ressources

POST/api/v1/materials/sync

Corps de la requête · application/json

Aucun champ requis ; un objet vide {} peut être envoyé.

Exemple de requête

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

Paramètres de réponse

Paramètre	Type	Description
`code`	integer	`0` en cas de succès
`msg`	string	`素材状态已同步` en cas de succès
`data.groups`	integer	Nombre de groupes actualisés cette fois
`data.adopted_groups`	integer	Nombre de groupes confirmés comme appartenant au compte actuel cette fois
`data.assets`	integer	Nombre de ressources actualisées cette fois
`data.removed_assets`	integer	Nombre de ressources confirmées comme invalides et supprimées

Corps de la réponse

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

La synchronisation lit les ressources une par une selon les groupes propres au compte actuel, et actualise le nom, le statut, les informations d'erreur et l'adresse des ressources. Elle ne supprime pas une ressource simplement parce qu'une requête n'a renvoyé aucun enregistrement : seule une nouvelle interrogation séparée confirmant son absence effective entraîne sa suppression. Il est donc sûr d'exécuter la synchronisation de façon répétée.

Réponses d'erreur

HTTP	msg	Description
`401`	`Invalid token`	Clé API absente, erronée ou expirée
`502` / `503`	`素材服务暂不可用`	Service de ressources anormal ; conservez les informations de requête et réessayez

Synchroniser le statut des ressources

Synchroniser le statut des ressources