Перейти к содержимому

Отмена массовой проверки аккаунтов и сверка выполненной работы

Остановите ожидающие группы NumDetect, дождитесь финального статуса, сохраните результаты и сверьте списания перед повторным запуском.

Иллюстрация процесса NumDetect к статье «Отмена массовой проверки аккаунтов и сверка выполненной работы»
Наглядная схема процесса, рассматриваемого в этой статье NumDetect.
Коротко

Остановите ожидающие группы NumDetect, дождитесь финального статуса, сохраните результаты и сверьте списания перед повторным запуском.

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

После запроса на отмену массовой задачи в NumDetect сохраните идентификатор задачи (job ID), дождитесь перехода в терминальный статус, загрузите готовые результаты и выполните сверку строк и групп, разделенных по странам и продуктам. Отмена останавливает только ожидающие группы; она не удаляет уже полученные ответы и не отменяет списания за группы, которые успели завершиться.

Остановка ожидающей работы и сохранение ссылки на задачу

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

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

Другие системы массовой обработки также предупреждают, что отмена может оставить выполненную работу без изменений (Axinom); их статусы и правила биллинга не определяют поведение NumDetect. Используйте задачу NumDetect как единственный достоверный источник информации.

Ожидание завершения задачи и проверка каждой группы

Отслеживайте конечную точку статуса массовой задачи, пока она не перейдет в состояние завершенной (completed), неудачной (failed) или отмененной (cancelled). Статус «в процессе» означает, что запрос на остановку еще не применился ко всем группам. NumDetect группирует проверку номеров телефонов по странам и продуктам, а проверку электронной почты — по продуктам. Группа, которая уже была отправлена в обработку, может завершиться после того, как оператор запросил отмену, в то время как ожидающая группа может быть отменена. Таким образом, «отмененная задача» и «отсутствие полезных ответов» — это не синонимы.

Зафиксируйте, какие группы «страна-продукт» завершились, какие не удались, а какие были отменены. Завершенная группа может содержать результаты «да», «нет» и «неизвестно» для строк. «Неизвестно» — это нерешенный результат, а не бесплатный или отрицательный. Этот обзор на уровне групп объясняет, почему остановленная задача может содержать как полезные результаты, так и возвращенные зарезервированные средства. Не перезапускайте весь исходный файл только потому, что одна группа не завершилась; это может привести к дублированию выполненной работы и затрат.

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

Сверка финального CSV с исходными данными

Результат в формате CSV от NumDetect сохраняет исходные строки и столбцы в их первоначальном порядке и добавляет столбцы numdetect_status, numdetect_country и product. Объедините его с сохраненным исходным файлом, используя стабильный идентификатор строки, и сравните количество строк. Отмечайте статусы валидных, дублирующихся и невалидных исходных строк отдельно от результатов каждого выбранного продукта: Зарегистрирован, Не зарегистрирован, Неизвестно, не поддерживается, не удалось или отменено. Результат «неизвестно» на уровне строки не должен преобразовываться в «Не зарегистрирован» при подготовке списка для последующей обработки.

Для отчета оператора об остановке суммируйте четыре пункта: исходный объем запроса, группы, завершенные до или во время отмены, группы, которые были отменены или не удались, и строки, требующие повторного запуска. Сохраняйте полученные ответы как датированные наблюдения. Список для повторной попытки должен содержать только нерешенные подходящие исходные строки и те продукты, которые все еще требуют проверки, после исправления исходной ошибки. Еще раз проверьте выбор страны и продукта перед созданием нового массового запроса и нового Idempotency-Key; старый ключ относится к исходной операции создания.

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

Сверка списаний перед одобрением нового запуска

Массовая отправка резервирует сумму по группам. Согласно документированным правилам NumDetect, завершенная группа оплачивается полностью, включая результаты «неизвестно». Неудачные или успешно отмененные группы освобождают зарезервированную сумму; уже завершенные группы остаются оплаченными. Сверьте финальную задачу и историю баланса с этим правилом. Не пытайтесь оценить сумму возврата, подсчитывая только строки «Зарегистрирован» и «Не зарегистрирован», и не предполагайте, что завершенная группа, состоящая полностью из результатов «неизвестно», является бесплатной.

Краткая заметка оператора может выглядеть так: «Запрошена отмена для задачи X; следующие группы завершены; следующие группы были отменены или не удались; следующие строки остаются нерешенными; финальное списание и возврат сверены с записью задачи; следующий запуск требует одобрения». Это позволит коллеге решить, нужно ли исправлять входные данные, запускать только выбранные нерешенные группы или оставить их без изменений.

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

Узнайте больше

Выберите информацию о продукте, которая соответствует следующему шагу в вашем рабочем процессе.

Источники

  1. numdetect.com
  2. docs.axinom.com

Подготовлено на основе документации продукта NumDetect и указанных источников.

Читайте также

Готовы проверить свои номера?

Начинайте сразу после регистрации — без ожидания одобрения. Пополните баланс и проверяйте реальные номера.

Зарегистрироваться бесплатно ↗