Demo
Demo
База знаний PMTA›Точка API§ 5.5

Подробности одного приёмника

/domainDetail
Разрез по одному домену

Отдаёт состояние одного домена получателя.

Вызов — GET /domainDetail?format=json&domain=gmail.com.

Поля ответа руководство не расписывает — только адрес вызова. Что именно придёт, проверяют на своём узле, а не берут из описания.

Доступ решает http-access по адресу, откуда пришёл запрос, — для чтения хватает уровня monitor. Ключ из http-api-key в заголовке X-API-Key даёт полный доступ с любого адреса.

Главная ловушка — ждать разбивку по адресам отправки. Раздел доменов складывает почту приёмника из всех его очередей. Если приёмник отказывает только одному адресу, в сумме это растворится — такой вопрос задают /queues с парой «домен/*».
Что делает Хаб. Не спрашивает: экрану «Мониторинг PMTA» хватает /domains, а подробностей одного приёмника он не показывает.
Рекомендуемые значения

О чём спрашивать эту точку:

Вопрос Она ли
что с одним приёмником в целом да
какому адресу отправки он отказывает нет — /queues с парой «домен/*»
все приёмники разом нет — /domains, верхушкой
что было вчера нет — это учёт
Адрес вызова и параметр domain — из руководства (§ 5.5.1). Разграничение вопросов наше; состав ответа руководство не описывает.
Пример в конфигурации
# один приёмник
curl -s 'http://127.0.0.1:8080/domainDetail?format=json&domain=gmail.com'
Состав ответа руководство не приводит — первый вызов на своём узле и есть описание полей.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

Связанные записи

1 связь

Где это видно

Приёмники, сложенные по всем адресам отправкиЭкран, показывающий то же самое человеку. § 5.5

Как проверить на узле
Посмотреть ответ и сверить с консолью:
curl -s 'http://127.0.0.1:8080/domainDetail?format=json&domain=gmail.com' | head -60
pmta show domains --errors gmail.com
Если консоль домен видит, а запрос отвечает пусто, — проверить написание домена и права адреса запроса в http-access.
◇

Что ещё почитать

3 статьи

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

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Разобраться с доставляемостью