Controlla lo stato del caricamento in blocco delle foto

Controlla periodicamente lo stato di un caricamento asincrono in blocco delle foto. Quando un lotto è sufficientemente grande, aggiungi foto della sede lo elabora in background e restituisce un requestId nell'oggetto request anziché i contenuti multimediali già elaborati. La dimensione del lotto che attiva questo comportamento è una configurazione lato server e non una costante pubblicata, quindi determina quale modalità è in uso verificando se è stato restituito request.requestId, non contando le tue immagini. Interroga periodicamente questo endpoint con quel requestId finché il processo non raggiunge uno stato definitivo.

Caso d'uso: aggiornare una barra di avanzamento del caricamento. Dopo aver caricato un lotto di grandi dimensioni, esegui il polling ogni pochi secondi mentre status è PROCESSING. Quando passa a SUCCESS o ERROR, leggi l'array photos per conoscere l'esito di ogni immagine: ciascuna voce contiene il mediaId risultante (in caso di successo) e una coppia status/errorMessage, così puoi mostrare esattamente quali file sono stati rifiutati e perché (dimensioni errate, formato non supportato, ecc.) anziché considerare fallito l'intero lotto.

Valori di stato: PROCESSING (elaborazione ancora in corso: ripeti il polling), SUCCESS (il processo ha terminato l'elaborazione), ERROR (il processo stesso è fallito; esamina photos[].errorMessage).

Lo stato status del processo indica soltanto che l'elaborazione è terminata, non che ogni immagine sia stata elaborata correttamente. Un processo con stato SUCCESS può comunque contenere foto rifiutate, come nell'esempio precedente. Quando il processo lascia lo stato PROCESSING, scorri photos[] e leggi i valori status e errorMessage di ciascuna voce per scoprire quali immagini sono state caricate correttamente.

Insidia del polling: lascia un intervallo tra le richieste di polling: un ciclo serrato di richieste a questo endpoint porta rapidamente a 429. Rispetta l'header Retry-After e preferisci un intervallo di pochi secondi. Un requestId sconosciuto o scaduto non verrà risolto, quindi esegui il polling soltanto con gli ID restituiti da una chiamata di caricamento recente.