Позволяет из типа объекта, а также его идентификаторов получить ЧПУ (человеко-понятный URL) для его дальнейшего шаринга пользователями через соц. сети, мессенджеры и т. д. Например, используя идентификатор объекта ID=23995560 с типом type=b (конкретное произведение), после выполнения запроса получим ЧПУ https://www.litres.ru/olga-kandela/yad-v-ego-krovi/.

ID функции

r_url_encoder

Кто может вызывать

Анонимный пользователь.
Авторизованное приложение.

Принимаемые параметры

id* – идентификатор объекта;
type* – тип объекта. Возможные значения:

a – автор;
b – конкретное произведение (книга, аудиокнига);
c – коллекция или подборка произведений;
s – книжная серия;
p – издательство.

Возвращаемые значения

urls* – массив объектов, содержит одну запись, со следующими атрибутами:

url* – ЧПУ (человеко-понятный URL). Например: https://www.litres.ru/olga-kandela/yad-v-ego-krovi/;
id* – идентификатор объекта.

Пример запроса на сервер

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_url_encoder",
                 "id": "url_encoder",
                 "param": {
                   "type": "b",
                   "id": "23995560"
                 }
           }
   ]
}

Пример ответа сервера

{
   "success": true,
   "time": "2014-11-07T16:21:02+03:00",
   "url_encoder" : {
      "success" : true,
      "urls" : [
        "url" : "http://www.litres.ru/olga-kandela/yad-v-ego-krovi/",
        "id" : "23995560"
      ]
   }
}