Метаданные фото и скриншотов
EXIF, даты, устройство, программа и GPS из JPEG, PNG, WebP и HEIC/HEIF.
POST /v1/image/metadata читает свойства изображения без ожидаемых параметров платежа.
Используйте метод для просмотра метаданных фото и скриншотов или передачи отчёта оператору.
curl https://api.kvitera.tech/v1/image/metadata \
-H "Authorization: Bearer $KVITERA_API_KEY" \
-F "file=@photo.jpg"Передайте один файл в поле file. Дополнительные поля и query-параметры не поддерживаются.
Типы и полный ответ смотрите в справочнике метода.
Что есть в отчёте
| Поле | Как использовать |
|---|---|
file | Формат, размер файла, размеры изображения, цветовой режим и число изображений/кадров |
metadata | Записанные устройство, программа, автор, ориентация и даты |
metadata.properties | Поддерживаемые значения с источником exif, xmp или png; truncated показывает сокращение |
location | GPS: valid, missing или invalid; координаты и доступная высота |
findings | Пояснения о различающихся датах, источниках и записанной программе обработки |
coverage | Полнота чтения источников и число проанализированных изображений |
limitations | Ограничения, которые нужно учитывать при интерпретации |
status: complete означает, что заявленные проверки выполнены. partial означает,
что часть сведений недоступна или сокращена. Для контейнера с несколькими изображениями
анализируется основное; ограничение primary_image_only отмечается явно.
assessment принимает signals_detected, no_signals_detected или inconclusive.
Это не вердикт подлинности. Обычное редактирование или экспорт могут оставить такие же
признаки. Отсутствие EXIF у скриншота нормально и само по себе не означает подделку.
Пиксели, происхождение картинки и факт поступления денег этим методом не проверяются.
Даты и координаты
В датах возвращаются исходная строка raw, интерпретация value, status и
timezone_known. Не считайте дату без часового пояса временем UTC. invalid означает,
что значение не удалось корректно интерпретировать; исходные свойства остаются доступны
в таблице, если их удалось прочитать.
При location.status: valid широта и долгота возвращаются в десятичных градусах.
Ноль является допустимой координатой. missing означает отсутствие координат в
поддерживаемых полях; invalid — наличие значений, которые не удалось интерпретировать.
GPS может содержать чувствительные сведения: учитывайте это при хранении и передаче отчёта.
Записанные координаты не являются независимым подтверждением места съёмки.
Лимиты, история и повторные запросы
- JPEG/JPG, PNG, WebP и HEIC/HEIF, до 15 МиБ и 100 Мп. Сложный файл может быть отклонён раньше.
- Стандартное ограничение — 30 запросов в минуту на компанию, общее для метаданных PDF и изображений, API-ключей и кабинета.
- Загрузка ограничена 15 секундами, анализ — 10 секундами. Используйте клиентский таймаут с запасом, например 35 секунд.
- Квота проверок чеков не расходуется. Отдельная тарифная квота для метаданных пока не применяется.
- Повторный запрос создаёт новый анализ и отчёт.
Idempotency-Keyэто поведение не меняет.
Исходное изображение не сохраняется. Отчёт и имя файла доступны участникам вашей компании в истории кабинета 30 дней. Сохраните JSON в своей системе для более длительного хранения. Бесплатная форма на лендинге не сохраняет отчёты в историю компании и использует общий бесплатный лимит с PDF.
Обработайте ошибки
| HTTP | Код | Действие |
|---|---|---|
| 401 / 403 | unauthorized, tenant_disabled | Проверить ключ и доступ компании |
| 408 | upload_timeout | Проверить соединение и повторить загрузку |
| 413 | upload_too_large | Выбрать меньший файл |
| 415 | unsupported_media_type | Передать JPEG, PNG, WebP или HEIC/HEIF |
| 422 | validation, invalid_image | Проверить поля запроса или выбрать исходный читаемый файл |
| 422 | image_complexity_limit, image_analysis_timeout | Выбрать менее сложный файл; не повторять его бесконечно |
| 429 | rate_limit | Подождать число секунд из Retry-After |
| 503 | overloaded, image_analysis_unavailable, database_unavailable | Повторить позже |
| 503 | feature_unavailable | Метод временно выключен |
Ответы содержат Cache-Control: no-store. Общий формат ошибок описан в
руководстве. Для проверки PDF используйте
отдельный метод.