wiki:session

Сессия API и авторизация

Авторизация API

Все команды Smotri API требуют авторизации API для доступа к ним. Для этого в параметрах каждой команды необходимо передавать ключ доверия (trustKey). Еще раз отметим, что для формирования ключа доверия необходимо получить ключ разработчика и пароль.

Сессия

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

Например:

  1. Вызываем команду получения сессии, передавая наш ключ доверия (trustKey).
  2. В ответ мы получаем sid, который необходимо передавать вместе с каждой последующей командой в рамках текущего сеанса (параметр trustKey в этой ситуации передавать уже не нужно).

Время жизни сессии - одна неделя. Если время жизни сессии подошло к концу, то очередное обращение к API с идентфикатором сессии приведет к ошибке exception.session.expired. В этой ситуации Вам необходимо воспользоваться снова командой получения сессии.

Сессия также позволяет:

  • авторизоваться в ней как пользователю Smotri.Com (что позволяет получить доступ к закрытому видео пользователя, возможность изменять данные видео и т.п.);
  • принять от имени неавторизованного пользователя в рамках сессии соглашение о доступе к эротике.