| Версия документа | 1.0 |
|---|---|
| Дата последнего обновления | 17 апреля 2018 г. |
| Адрес постоянного размещения | https://docs.litres.ru/x/kYh8 |
Аннотация
Партнеры «ЛитРес», подключенные к партнерской программе «ЛитРес», могут использовать в своих книжных сервисах ЛитРес-читалку or4.js. Доступ осуществляется по API, описанному в данном документе. Для начала работы с API партнеру необходимо получить от «ЛитРес» номер партнера и секретный ключ.
Формирование ссылки для открытия книги в or4
Доступ к API формируется по ссылке:
http://www.litres.ru/static/or4/view/or.html?baseurl=/readmsk/art_id/timestamp/mssidn_as_userid/sha/
, где:
- readmsk – захардкоженный префикс. Для каждого партнера используется индивидуальный префикс;
- art_id – числовой ID книги на ЛитРес;
timestamp – текущий UNIX-таймстамп, время в секундах с 00:00:00 UTC 1 января 1970. Принимается только валидный таймстамп – не старше суток от now ()
;- sha – хеш SHA-256 в верхнем регистре, формируемый индивидуально для каждого запроса и рассчитываемый как «$timestamp:$art_id:$mssidn_as_userid:$secret_key»,
где все параметры аналогичны описанным выше, а $secret_key – секретный ключ партнёра, полученный от «ЛитРес» и используемый только для формирования sha; - mssidn_as_userid – уникальный идентификатор пользователя – мобильный телефон абонента в 10-тизначном формате, например, 9030062003.
https://www.litres.ru/static/or4/view/or.html?baseurl=/readmsk/616825/1494689135/9266981859/f76bfacb8c4be99c016dcef792c895df7cd92877cd6fa66fc5817dfb87458ef9/.
Все параметры являются обязательными.
Программисты Windows! Проверьте свои таймстампы на http://www.timestampgenerator.com/.
Обратите внимание, что вычислять таймстамп из местного времени нельзя! Таймстамп считается по UTC, без сдвига летнего/зимнего времени. В Wikipedia есть множество описаний по теории таймстампа, а также есть огромное количество исходников для любого языка, от Perl до PL/SQL.