Сессия API и авторизация
Авторизация API
Все команды Smotri API требуют авторизации API для доступа к ним. Для этого в параметрах каждой команды необходимо передавать ключ доверия (trustKey). Еще раз отметим, что для формирования ключа доверия необходимо получить ключ разработчика и пароль.
Сессия
Если Вы хотите совершить несколько запросов к API с одним и тем же ключом доверия (trustKey), вы можете открыть сессию и авторизоваться в ней. После этого в рамках сессии авторизация API требоваться не будет.
Например:
- Вызываем команду получения сессии, передавая наш ключ доверия (trustKey).
- В ответ мы получаем sid, который необходимо передавать вместе с каждой последующей командой в рамках текущего сеанса (параметр trustKey в этой ситуации передавать уже не нужно).
Время жизни сессии - одна неделя. Если время жизни сессии подошло к концу, то очередное обращение к API с идентфикатором сессии приведет к ошибке exception.session.expired. В этой ситуации Вам необходимо воспользоваться снова командой получения сессии.
Сессия также позволяет:
- авторизоваться в ней как пользователю Smotri.Com (что позволяет получить доступ к закрытому видео пользователя, возможность изменять данные видео и т.п.);
- принять от имени неавторизованного пользователя в рамках сессии соглашение о доступе к эротике.