js-клиент API Яндекс.Почты для доменов (ЯПДД, https://pdd.yandex.ru)

API ЯПДД

API Яндекс.Почты для доменов позволяет производить административные действия над вашими ящиками из программного кода (например, из кода вашего сайта).

API представляет собой интерфейс http(s) вызовов. Каждый вызов выполняет какое-то действие. Параметры передаются в строке запроса или в теле запроса. Все параметры надо передавать в кодировке urlencode. Результат выдается в теле ответа.

Я для себя и других администраторов доменов, которые захотели или захотят перейти на ЯПДД, написал генератор этих ссылок для вызовов, т.к. мне не удобно было пользоваться не-API вариантом Яндекса. Неудобство, которое признал Яндекс, касается установки переадресации почты у пользователей, например, на время их отпуска. На момент написания программы (2011-05-01) для того, чтобы установить переадресацию, администратору домена необходимо:

1. Залогиниться под адресом, с которого надо установить переадресацию
2. Создать правило сортировки, пересылающее письма на второй адрес
3. Разлогиниться
4. Залогиниться под вторым адресом, открыть сообщение, запрашивающее подтверждение желания получать переадресованные письма
5. Перейти по ссылке, указанной в письме и получить сообщение, что эту ссылку следует переслать по первому адресу
6. Вновь перелогиниться под первым адресом и перейти по этой ссылке
7. Нажать кнопку, включающую таки переадресацию, поражаясь абсурду, что ты сам себе подтверждаешь включение переадресации.

Если Яндекс доведёт процедуру до простоты API, в представленном костыле надобности не будет.

Особенность реализации такая, что мне на сервер не передаётся Ваш токен, который является ключом к управлению вашей ЯПДД, т.к. токен хранится в части адресной строки после знака "#", который используется для адресации внутренних переходов по странице. Так задумал для тех, кто не хочет давать мне свой токен. Можете проверить любым снифером: не передаётся, как и другие переменные. Меньше знаю — крепче сплю, и вообще, сами админьте свою почту =) Для пущей безопасности, никаких сторонних скриптов (типа статистики, фреймворков) тоже не подключал — всё написано с нуля мной, админом почемубынета. Для общения с сервером Яндекса ссылки генерятся с протоколом "https".

После выполнения первого пункта (Активации API), можно поставить токен в предлагаемое поле и добавить страницу в закладки (избранное). В дальнейшем, просто можете держать эту страничку открытой и выполнять из неё какие-нибудь действия, заполняя поля, переходя по ссылкам и читая ответы. В Хроме ответы сервера могут казаться пустыми — надо смотреть код страницы.

Сам — разумеется — пользуюсь этой своей программой для нескольких доменов. Для каждого — своя закладка.

Вижу некоторые недостатки интерфейса. Обновлять версии — кнопкой F5. Конструктивные предложения — рассматриваю, токены — нет =)

История

2011-09-27: Буилд 347. Добавлено название домена в заголовок.

2011-09-12: Буилд 335. По просьбе пользователя добавил пункты API 30,31,32 про дополнительных админов домена. И заодно добавил пункты 33а, 33б - про общий список рассылки.

2011-08-10: Буилд 330. По просьбе пользователя добавил ссылку на простой вход в ЯПДД через https://mail.yandex.ru/for/domainname. От себя добавил ещё https-ссылку на управление ЯПДД через родной интерфейс. В шапке ссылку http://pdd.yandex.ru/ сделал SSL-ной. Поднял номер версии до 1.1.

2011-08-10: Буилд 300 (тот же). Внезапно замечено, что Яндекс исправился и теперь пункты 27 и 28 (авторизация по временному токену) работают.

2011-05-11: Буилд 300. Рождение версии 1.0. Пункт 28 не работает по причине Яндекса.