Se connecterCommencer gratuitement
Référence APIRelancer l'analyse antivirus d'un transfert
POST/v1/transfers/{id}/rescan

Relancer l'analyse antivirus d'un transfert

Replace un transfert dans la file d'analyse antivirus en repassant son statut de scan à `pending`.

2 min de lectureTélécharger en PDF

Réponse exemple

{
  "note": "The coffrify-scan-transfer cron picks up pending transfers within a few minutes.",
  "short_code": "AB12CD",
  "transfer_id": "trf_9f2c1a7e4b",
  "new_scan_status": "pending",
  "queued_for_rescan": true,
  "was_already_pending": false,
  "previous_scan_status": "flagged"
}
POST/v1/transfers/{id}/rescanReplace le transfert dans la file d'analyse antivirus.

Replace un transfert existant dans la file d'analyse antivirus en repositionnant son statut de scan (scan_status) sur pending. Le cron interne coffrify-scan-transfer récupère ensuite les transferts en attente et exécute l'analyse au prochain passage, généralement en quelques minutes. Cette route est utile après la mise à jour d'un motif de détection (signature CVE) ou pour revérifier un transfert préalablement signalé. L'opération est idempotente côté métier : si le transfert est déjà en attente d'analyse, aucune mise à jour n'est effectuée et le champ was_already_pending vaut true.

Authentification

Cette route exige une clé API valide disposant du scope transfers:write. Le transfert ciblé doit appartenir au workspace associé à la clé : la recherche est filtrée sur le workspace_id du contexte d'authentification, donc un identifiant appartenant à un autre workspace renvoie une erreur not_found.

Paramètres de chemin

ChampTypeRequisDescription
idstringOuiIdentifiant du transfert à replacer dans la file d'analyse, extrait du chemin de l'URL.

Corps de la requête

Aucun corps de requête n'est attendu : l'identifiant du transfert est lu directement depuis l'URL. Un corps vide ou absent est accepté. Vous pouvez fournir un en-tête Idempotency-Key pour bénéficier de la déduplication standard des requêtes d'écriture.

Réponse

En cas de succès, la route renvoie un statut 200 avec un objet décrivant la mise en file. Le champ transfer_id reprend l'identifiant ciblé et short_code le code court du transfert. previous_scan_status indique le statut d'analyse avant l'opération, tandis que new_scan_status vaut toujours pending. queued_for_rescan est toujours true, et was_already_pending signale si le transfert était déjà en attente (auquel cas aucune écriture n'a eu lieu). Le champ note rappelle que le cron traite les transferts en attente sous quelques minutes.

ChampTypeDescription
transfer_idstringIdentifiant du transfert replacé dans la file.
short_codestringCode court public du transfert.
previous_scan_statusstringStatut d'analyse avant l'appel (ex. flagged, clean, pending).
new_scan_statusstringToujours pending après l'opération.
queued_for_rescanbooleanToujours true : indique que la demande de réanalyse a été prise en compte.
was_already_pendingbooleantrue si le transfert était déjà en attente (aucune mise à jour effectuée).
notestringMessage rappelant le délai de traitement par le cron coffrify-scan-transfer.

Erreurs

CodeQuandRésolution
404 not_foundAucun transfert ne correspond à l'id fourni dans le workspace de la clé API.Vérifiez l'identifiant et que le transfert appartient bien au workspace de la clé utilisée.
410 not_foundLe transfert existe mais a été supprimé (status = deleted).Le transfert n'est plus analysable ; il a été supprimé et ne peut être remis en file.
500 internal_errorErreur lors de la lecture ou de la mise à jour du transfert en base.Réessayez ultérieurement ; si le problème persiste, contactez le support avec le request_id renvoyé.

Voir aussi