Что такое проверка аватара? Изображения, публичные профили и результаты
Проверка аватара позволяет проанализировать изображение или публичный аватар для идентификатора. Узнайте о результатах и ограничениях для разных источников.

Проверка аватара дает разные ответы в зависимости от того, является ли входным данным изображение или идентификатор учетной записи.
Проверка аватара изучает изображение, уже имеющееся у команды, или запрашивает, доступен ли публичный аватар для поддерживаемого идентификатора учетной записи. AvatarLookup начинает с анализа профиля по изображению для загруженной картинки или публичного HTTPS URL-адреса, а затем предлагает анализ аватаров WhatsApp и поддерживаемых email-адресов, если известен только идентификатор. Специализированные пакетные продукты для конкретных источников обрабатывают соответствующие файлы. Результат описывает изображение или сигнал публичного профиля; он не устанавливает личность человека.
Начните с изображения: анализ профиля по изображению
Когда входным данным является само изображение, анализ профиля по изображению — это самый прямой путь. Веб-сайт AvatarLookup принимает загруженное изображение или публичный HTTPS URL-адрес изображения. Документированный API для изображений принимает multipart-загрузку файла; поддерживаемые форматы файлов: JPEG, PNG, WebP и GIF. Ознакомьтесь с актуальной официальной документацией API перед интеграцией и убедитесь, что файл соответствует документированным требованиям к размеру. Не предполагайте, что API принимает URL или base64-полезную нагрузку только потому, что на веб-сайте есть опция URL.
Результат описывает предоставленное изображение, включая тип изображения и алгоритмические оценки видимых атрибутов портрета, если изображение это позволяет. Полученный из контента отпечаток относится к изображению, а не к учетной записи в мессенджере. Мультяшный персонаж, питомец или объект все равно могут дать завершенный анализ с неизвестными атрибутами внешности. Команде следует помечать эти значения как оценки, избегать превращения их в демографические факты и не использовать их при принятии решений о соответствии требованиям или доверии к человеку.
Этот путь подходит для набора данных, который уже содержит пригодное для использования изображение и требует последовательного описания того, что на нем видно. Он не дает ответа на вопрос, публикует ли этот снимок учетная запись email или телефона. Если у команды есть только идентификатор, используйте путь, специфичный для источника, вместо того чтобы делать вид, что анализ изображения может найти учетную запись, стоящую за ним.
Если известен только идентификатор, выберите источник
Синхронные одиночные и мульти-проверки документированы для номеров WhatsApp и поддерживаемых адресов электронной почты Gmail, Yandex и Mail.ru. Сервис запрашивает информацию о публичном аватаре, связанном с этим поддерживаемым источником, и может проанализировать доступное изображение. Перед отправкой определите источник и подтвердите, что домен электронной почты или рабочий процесс для телефона поддерживаются. Документация по продуктам и API AvatarLookup — это подходящее место для проверки текущей доступности сервиса.
Результат для публичного аватара имеет более узкое значение, чем анализ изображения из загруженного файла. Сервис может сообщить, доступны ли сигнал учетной записи для конкретного источника и публичный аватар. Отсутствующее публичное изображение должно оставаться отсутствующим публичным изображением. Руководство Google по профилям описывает, как пользователи управляют видимостью информации профиля, что является одной из причин, по которой командам не следует делать выводы о личности или статусе почтового ящика на основании отсутствия изображения. Доступное изображение также не может установить, кто именно его выбрал.
Не переносите семантику результатов между источниками. Проверка email поддерживает только документированные домены Gmail, Yandex и Mail.ru, в то время как WhatsApp использует номера телефонов. Telegram, Viber, MAX, LINE и Zalo документированы через специфические пакетные продукты, а не через синхронные проверки одиночных аватаров. Это различие помогает разработчику выбрать корректный рабочий процесс перед проектированием меток интерфейса или правил проверки.
Используйте пакетные файлы для конкретных источников для больших списков
Пакетные продукты AvatarLookup являются асинхронными и специфичными для каждого источника. Команда с подходящим списком подготавливает файл TXT или CSV с одним идентификатором на строку, выбирает продукт, соответствующий источнику, отправляет задачу, а затем проверяет статус и загружает результат после завершения. Продукты для телефонов, имен пользователей и email имеют разные правила ввода и столбцы результатов. Не существует единого взаимозаменяемого вывода «пакетной проверки аватаров».
Список email использует пакетный продукт для аватаров email; список имен пользователей Telegram использует продукт для профилей имен пользователей Telegram. Продукты для телефонов имеют свою собственную обработку стран. Применяются специфические для продукта минимумы, максимумы и правила размера файлов; при подготовке производственного файла обращайтесь к актуальной документации API. Задача может завершиться позже, поэтому интеграция не должна представлять асинхронную отправку так, будто каждый результат уже доступен в ответе на запрос.
Файловый рабочий процесс полезен для ведения записей контактных данных в масштабе, в то время как синхронная проверка подходит для одной активной записи, а синхронный мульти-вызов — для небольшой группы идентификаторов. Выбирайте продукт в зависимости от бизнес-задачи, типа идентификатора и поддерживаемого источника. Избегайте подачи смешанного списка в продукт, предназначенный для одного источника, или превращения пустого поля вывода в обобщенный вывод об учетной записи.
Интерпретируйте результат перед использованием
Аватар может быть фотографией человека, логотипом, иллюстрацией или изображением, не имеющим отношения к делу. Алгоритмические оценки описывают визуальные особенности на картинке; они не подтверждают юридическую личность, владельца учетной записи, возраст или пол. Доступность публичного профиля указывает на то, что выбранный источник делает доступным для проверки. Источник может вернуть результат Не определено, который должен оставаться отличным от завершенного результата без публичного аватара.
Для синхронных мульти-проверок документированный маркер exists указывает, был ли получен результат. Его нельзя переводить как «учетная запись существует» или «учетная запись отсутствует». Завершенный отрицательный сигнал аватара или учетной записи имеет свое собственное значение, в то время как недействительный, неудачный или неопределенный элемент не дает отрицательного вердикта. Помечайте эти случаи отдельно в рабочем процессе обработки контактных данных и сохраняйте название источника рядом с наблюдением.
Практический экран обзора может отображать исходный идентификатор, выбранный продукт, время проверки, был ли доступен публичный аватар и был ли результат завершен или остался неопределенным. Затем проверяющий может решить, обновить ли изображение профиля, оставить запись пустой или запросить ручную проверку. Не заполняйте профиль человека автоматически на основе публичного изображения без соответствующего правила обработки данных. Полезный результат — это лучший контекст данных, а не утверждение, что картинка доказывает, кто есть кто.
Часто задаваемые вопросы
Как команды могут выбирать между проверкой изображения и поиском аватара?
Используйте анализ профиля по изображению, когда картинка уже доступна. Используйте проверку WhatsApp или поддерживаемого email для конкретного источника, когда известен только идентификатор учетной записи.
Как команды могут интерпретировать неизвестные атрибуты внешности?
Относитесь к ним как к результату анализа изображения, а не как к проверенному демографическому описанию. Нечеловеческое или неясное изображение все равно может дать завершенный результат.
Как команды могут обрабатывать отсутствие публичного аватара?
Записывайте источник и отсутствие публичного изображения отдельно от наличия учетной записи и отдельно от неопределенной проверки.
Как команды могут обрабатывать большой список контактов?
Выберите документированный пакетный продукт для этого источника, подготовьте его ввод в формате TXT или CSV и дождитесь завершения асинхронной задачи, прежде чем просматривать его специфический для источника вывод.
Узнать больше
Выберите информацию о продукте, которая соответствует следующему шагу в вашем рабочем процессе.