Позволяет из ЧПУ (человеко-понятного URL) определить тип объекта, а также его идентификаторы. Например, по URL http://www.litres.ru/dmitriy-gluhovskiy/metro-2033/ определяется, что это книга с идентификатором «128391» и токеном «biblio_book». Полученные данные можно использовать в других запросах или для формирования «классического» URL, например: http://www.litres.ru/pages/biblio_book/?art=128391.

ID функции

r_url_decoder

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

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

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

url* – исходный ЧПУ (человеко-понятный URL). Например: http://www.litres.ru/dmitriy-gluhovskiy/metro-2033/.

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

urls* – массив объектов, содержит либо одну запись, если объект найден, либо 0 (пустой массив) если URL не удалось сопоставить никакому объекту. Для каждого объекта будут возвращены следующие значения:

• type* – тип объекта. Возможные значения:
  • a – автор;
  • b – конкретное произведение (книга, аудиокнига);
  • c – коллекция или подборка произведений;
  • s – книжная серия;
  • p – издательство.
• token­­­* – атрибут для формирования «классического» URL объекта. ­Например, значение token=biblio_book, в классическом URL будет использоваться так: http://www.litres.ru/pages/biblio_book/?art=128391;
  id* – идентификатор объекта.

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

{
   "app": "1",
   "time": "2014-11-07T16:21:02+03:00",
   "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
   "sid": "7bad5f2fb752ee957a4ab74aaac7711g",
   "requests": [
           {
                 "func": "r_url_decoder",
                 "id": "url_decoder",
                 "param": {
                   "url": "http://www.litres.ru/dmitriy-gluhovskiy/metro-2033/"
                 }
           }
   ]
}

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

{
   "success": true,
   "time": "2014-11-07T16:21:02+03:00",
   "url_decoder" : {
      "success" : true,
      "urls" : [{
        "type" : "b",
        "token" : "biblio_book",
        "id" : "128391"
      }]
   }
}