For developers

Получение token

Чтобы работать с большенством методов API требуется получить access_token пользователя.

1. Открытие диалога авторизации – https://tviply.com/api/oauth

Параметры:

  • client_id – Идентификатор Вашего приложения.
  • redirect_uri – Адрес, на который будет переадресован пользователь после прохождения авторизации.

Пример запроса:

https://tviply.com/api/oauth?client_id=1&redirect_uri=https://example.tv/oauth_back

Если пользователь не вошел на Tviply, то в диалоговом окне ему будет предложено выполнить вход.

2. Получение code

После успешной авторизации приложения браузер пользователя будет перенаправлен по адресу redirect_uri, указанному при открытии диалога авторизации.
При этом код для получения ключа доступа code будет передан как GET-параметр:

https://example.tv/oauth_back?code=67c5e3b9f3d2fad016b4cee7c7b9c711

3. Получение access_token

Для получения access_token необходимо выполнить запрос с Вашего сервера на https://tviply.com/api/oauth/access_token, передав следующие параметры:

Параметры:

  • client_id – Идентификатор Вашего приложения.
  • client_secret – Секретный ключ Вашего приложения.
  • redirect_uri – Адрес, который использовался при получении code на первом этапе авторизации.
  • code – Временный код, полученный после прохождения авторизации.

Пример запроса:

https://tviply.com/api/oauth/access_token?client_id=1
&client_secret=2a8ccfd229e40c67a013d9024a129c09e5f9402258e427207cab5aaba6829d69
&redirect_uri=https://example.tv/oauth_back
&code=67c5e3b9f3d2fad016b4cee7c7b9c711

Email и ключ доступа access_token к методам API будет передан в ответе запроса.

Далее в документации access_token будет представляться как token

Методы API