Vkontakte: как пользоваться wall.post, нужен ли теперь wall.savePost?

---

3 февраля 2011 года на небезызвестном ресурсе vkontakte.ru произошло обновление их API: устарели методы activity.set и activity.get, но и добавился метод wall.post.
Перед началом сразу оговорюсь, что речь идёт о приложениях с посредником.
Получается, что теперь для отправки записей на стену у нас есть 2 метода:
- wall.post
- wall.savePost

В чем между ними разница?
- wall.post:
— Отправляет на стену записи в одну команду API. Не сильно важно, но удобно.
— Данный метод отображает записи от приложения в новостной ленте.
— Данный метод позволяет отправлять вместе с записью аудио- или видео-приложение.
— С этой записи невозможно открыть приложение в попап окне (в том самом, в котором обычно делают картинку и надпись "Приходи играть к нам!", по клику на которое открывается реальное приложение). По клику на картинку, что постится вместе с текстом будет открываться альбом с этой картинкой.
— post_id генерирует контакт.
— (спорный момент): В этом сообщении администрация обещала в скором времени сообщить, как же загружать картинки с клиента и отправлять на их на стену с помощью wall.post. Однако, никакой информации спустя месяц от них не поступило. Но в документации появилась интересная строчка:
Но, к сожалению, у меня не получилось. От сервера приходит что-то вроде 2041c53171:w, но ни 2041c53171:w, ни photo2041c53171:w как attachment не позволяли мне увидеть картинку при отправке. Возможно, документация опережает технические возможности, а возможно мне не хватает ума понять, в чем тут дело.


- wall.savePost:
На самом деле, здесь всё наоборот.
— 3 шага для отправки записи на стену. (см. Загрузка фотографий на стену пользователя).
— Не отображает записи в новостной ленте.
— Не позволяет прицепить к записи видео- или аудио-запись.
— Открывает приложение попап окне.
— post_id у записи генерирует клиент. post_id позволяет идентифицировать сообщение среди многих других и передать какую-нибудь информацию (например, ID квеста, который просят помочь пройти: это позволяет не соединятся с сервером лишний раз, до перехода в "большое" приложение).
— Позволяет загружать фотографии с клиента.

О wall.savePost в интернете сказано достаточно много, заставить его работать у себя не вызывает затруднений. Но иначе дело обстоит с wall.post.
Дело в том, что ребята из контакта забыли сказать о том, что, оказывается, чтобы пользоваться этим методом нужно снова обновить посредник (например, отсюда).
А дальше начинаются пляски. В документации wall.post ясно сказано, что нужно вызывать JS API. Через... VK.api. Это как?
JS API обычно вызывается через VK.callMethod. VK API соответственно через VK.api.
Но просмотрев документацию дальше понимаем, что этот новый метод возвращает ошибки и вообще, ведёт себя как обычный VK.api. Недолго думая пробуем сохранить сообщение новым методом через VK.api, но получаем ошибку. В чем же дело?

А дело в том, что теперь VK.api делится на 2 части. Одна из них — старое VK API, а другая — какой-то гибрид JS API и VK API. К этому выводу я пришел, просматривая (весьма дурно пахнущий, кстати) код из их APIConnection.as и сравнивая его с прошлой версией. Добавился новый метод:
Неплохо было бы рассказать им о сеттерах, но это в другой раз. Что это ещё за directApiAccess? Нехитрый CTRL+F по документу наталкивает на этот кусок:
Первая часть кода, выполняющиеся по условию !sendingLC || directApiAccess представляет собой блок кода из старого API. Ветка по else — новую. Чтобы вызвать ветку else нам нужно заставить directApiAccess быть false, и как-то убить sendingLC.
Первое осуществимо через метод, описанный выше. Причем недокументированный метод. Скажите мне, что может быть хуже недокументированного метода Вконтакте, необходимого для работы?
Разбираться с этим я долго не стал. У нас не так много команд, которые нужно пускать по ветке else, поэтому я сделал вот так:
К счастью, такой простой фикс помог и заставил избавиться от возни с тем странным методом.

Резюмируя, можно сказать, что старый метод wall.savePost остается необходим для записей, по клику на который должно открываться попап-окно или к которому необходима картинка, сгенерерированная клиентом.
Для всех остальных вещей есть wall.post. Кстати, чтобы добавить интерактивности вроде "Пройди со мной квест!" используя wall.post придется генерировать ссылку на приложение и отправлять как часть сообщения, в которой будет содержаться, например, post_id.