Фото возврата Маркета через API: проверьте Content-Type

Фотография возврата скачалась, но программа её не открывает. Прежде чем просить покупателя отправить снимок заново, проверьте, что интеграция сохранила именно изображение и выбрала верный формат файла.

Этот порядок предназначен для сотрудника, который разбирает возвраты вместе с разработчиком интеграции. Он помогает локализовать ошибку получения файла, но не определяет решение по возврату.

Сверьте источник фотографии

Метод «Получение фотографий товаров в возврате» получает снимки, приложенные покупателем к заявлению. Он доступен для FBY, FBS, Экспресс и DBS.

По документации, imageHash берут из поля images решения по товару в ответе метода информации о возврате либо списка невыкупов и возвратов. Хеш фотографии не стоит подменять идентификатором товара или самостоятельно вычисленным именем файла.

Запишите связку из параметров исходного запроса: campaignId, orderId, returnId, itemId и imageHash. В ней itemId обозначает товар в возврате. Это позволяет проверить, что снимок относится к нужной позиции, а не только к похожему заказу.

Сначала проверьте ответ, потом расширение

Успешный ответ метода содержит бинарное изображение image/jpeg или image/png. Его тип определяют по заголовку Content-Type. Максимальный размер изображения в документации указан как 50 МБ.

Перед сохранением разработчику стоит проверить HTTP-статус, заголовок типа и полученное тело ответа. Не присваивайте каждому ответу расширение .jpg по умолчанию. Переименование файла не превращает PNG в JPEG, а сообщение об ошибке в фотографию.

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

Сохраните исходник для сравнения

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

Не заменяйте исходник конвертированной версией во время разбора. В журнале диагностики достаточно времени запроса, статуса, типа, размера, идентификаторов операции и результата открытия. Ключ авторизации в такой журнал не включают.

Подтвердите результат на том же возврате

После исправления откройте сохранённое изображение и сверьте его с той же позицией возврата. Зафиксируйте, на каком этапе возникало и исчезло расхождение. Если файл теперь открывается, но товар или повреждение на нём неразличимы, это уже вопрос достаточности материалов, а не формата API.

Работа завершена, когда понятны происхождение снимка, его фактический тип и путь сохранения. Сам по себе открывшийся файл не подтверждает ни состояние товара, ни обоснованность решения по возврату.