Подключение MeowID к Zhongdamaopu

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

• Аккаунт MeowID с правом создания проекта и API-ключа.
• Аккаунт администратора уровня 99 в мини-приложении для настройки и синхронизации.
• Существующие карточки кошек и одобренные фотографии для регистрации и проверки.

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

1. Войдите в консоль MeowID и создайте проект для каталога.
2. Скопируйте ID проекта из его сведений: он понадобится в поле «项目编号» мини-приложения.
3. Проверьте баланс и действующие тарифы, при необходимости пополните счёт. Регистрация и распознавание могут расходовать платный лимит.

Используйте один проект для одного каталога. Синхронизация создаст удалённую запись для каждой локальной карточки; заранее создавать всех кошек вручную не нужно.

Откройте API Keys, выберите тот же проект и создайте ключ с полным доступом либо со всеми четырьмя разрешениями ниже.

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

1. Войдите администратором уровня 99 и откройте 关于 → 小程序配置 → 识猫服务 (О приложении → Настройки мини-приложения → Распознавание кошек). Администраторы меньшего уровня не видят этот пункт.
2. Выберите режим MeowID и сохраните его.
3. Укажите ID проекта, API-ключ и базовый URL API. По умолчанию это https://platform.meowid.net. Адрес документации https://meowid.net/developers не является адресом API.
4. Для начала оставьте 5 кандидатов, сохраните настройки и проверьте подключение.

ID и ключ должны относиться к одному проекту. Сохранённый ключ повторно не отображается: пустое поле сохраняет прежнее значение, а не означает отсутствие ключа.

Снимки мини-приложения показывают реальный китайский интерфейс; названия и числа могут отличаться. Число кандидатов ограничивает результаты поиска и не связано с лимитом фотографий на кошку.

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

Начните с лимита для контроля расходов на старые фото. Если есть только три фото, отправятся три, без повторов ради пяти. Без фото можно синхронизировать карточку. Уменьшение лимита не удаляет удалённые изображения.

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

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

Загрузка не означает завершение регистрации. Ещё нужны обрезка и извлечение признаков. Проверьте очередь проекта:

• queued / running: принято, ожидает или обрабатывается.
• completed: регистрация закончена; проверяйте распознавание по доступным изображениям.
• waiting_user: подтвердите целевую кошку в консоли.
• failed: изучите ошибку; сбой с квитанцией не приводит к повторной отправке как новой фотографии.

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

1. Выберите связанную локальную кошку с доступными зарегистрированными изображениями и чёткое фото одного животного, желательно другое для проверки.
2. В каталоге нажмите 识别 (Распознать) рядом с поиском, затем снимите фото или выберите его из альбома.
3. Откройте карточку кандидата и проверьте имя, фотографии и ссылку.

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

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

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

• Сохраняйте историю и продолжайте нужной кнопкой без пересоздания карточек.
• Сначала проверяйте неопределённые загрузки в очереди, не повторяйте их сразу.
• Не добавляйте одно фото отдельными записями: они могут отправиться независимо.
• Перед сменой проекта или ключа проверяйте принадлежность. Используйте один проект для одного каталога.

См. справочник API и иллюстрированное руководство по консоли. В сообщении об ошибке укажите текст, ID задачи и время, но не публикуйте API-ключ.