Панель удобна для разовой задачи, но не для среды staging, которой нужны свежие ящики при каждом развертывании, или продукта, создающего аккаунты при подключении клиента. Для таких процессов нужен API.
Yearly дает REST-доступ для отправки задач, проверки статуса и получения результатов в собственные системы. Частые сценарии — CI, административные панели и внутренние инструменты. Не записывайте возвращенные учетные данные в журналы и сразу перемещайте их в утвержденное хранилище.
Что обычно автоматизируют
- CI/CD: подготовить 10 тестовых Gmail при развертывании ветки staging
- Подключение: выдать ящики при регистрации новой организации в продукте
- QA: передавать свежие аккаунты наборам Playwright или Selenium
- Внутренние операции: кнопка «создать 50 Yahoo для проекта X»
Базовый процесс интеграции
- 1Подключите Yearly и создайте ключ в Dashboard → API
- 2Отправьте `POST /tasks` с провайдером (`gmail`, `yahoo` или `outlook`), количеством и параметрами имен
- 3Сразу сохраните `task_id` из ответа
- 4Проверяйте `GET /tasks/{id}` раз в 30–60 секунд до `completed` или `failed`
- 5Получите список аккаунтов из деталей задачи и синхронизируйте со своей базой
Результат не мгновенный
Не блокируйте интерфейс в ожидании. Задача на 50 Gmail может занять 30–90 минут. Сразу верните ID и уведомите пользователя после завершения через доступный механизм: webhook, письмо или опрос вашим бэкендом.
Обязательная безопасность
| Правило | Зачем |
|---|---|
| Ключи только на бэкенде | Во фронтенде ключ будет скомпрометирован |
| Отдельный ключ на среду | Утечка staging не затронет production |
| Периодически меняйте ключи | Снижает ущерб при утечке |
| Шифруйте сохраненные пароли | Это чувствительные данные |
| Журналируйте ID задач, а не пароли | Диагностика без раскрытия данных |
Если что-то пошло не так
- Возможен частичный успех. Проверяйте статус каждого аккаунта и повторяйте сбои в новой задаче.
- Соблюдайте ограничения частоты и увеличивайте интервал: 30, 60, затем 120 секунд.
- Если `processing` длится более трех часов, зафиксируйте и отправьте предупреждение; не создавайте дубликат автоматически.
- Сохраняйте `task_id` до опроса. После сбоя скрипта продолжайте ту же задачу.
Документация API
Полный справочник конечных точек, форматы запросов и ответов и заголовки авторизации доступны в панели в API Access после подключения Yearly.
Создание — только первый этап. Руководство по интеграции с инструментами коммуникации описывает передачу, а процесс выдачи почтовых аккаунтов — согласование, владение, безопасное хранение и закрытие вокруг API.