Public : API Антипиратство

Версия документа1.0
Дата последнего обновлениядекабрь 2017 г.
Адрес постоянного размещенияhttps://docs.litres.ru/x/gIh8

Введение

Компания «ЛитРес» имеет каталог отпечатков нескольких сотен тысяч текстов. По многим из этих текстов есть информация о текущем правовом статусе. В частности мы знаем, защищаемый ли это контент, часто располагаем точной мета-информацией для текста: кто и когда написал и прочее. В целях повышения прозрачности и законности размещения произведений и их частей в сети интернет, в том числе на публичных ресурсах, компания «ЛитРес» предоставляет сервис проверки правового статуса любого вашего текста.

Готовая реализация

Реализация данного API доступна бесплатно в библиотеке CPAN: Text::DistillБиблиотека включает в себя скрипт plagiarism_check.pl, уже интегрированный с данным API.
Для установки на linux наберите в командной строке:

> cpan Text::Distill

затем, для проверки файла, наберите:

> plagiarism_check.pl file.epub

Получение информации по отпечатку

Отправка запроса

POST-запрос отправляется на URL: http://partnersdnld.litres.ru/copyright_check_by_gems/.

Принимает следующие параметры:

  • gems – отпечаток, полученный  с помощью функции TextToGems из модуля Text::Distill. Разделенный запятыми список целых положительных 32-х битных чисел.

Ответ сервера

В ответ сервер вернёт фрагмент JSON с описанием найденных для данной книги соответствий (если таковые имеются) и общим вердиктом:

{
  "verdict": "protected", # free|public_domain|unknown
  "matches": [{
    "id": "5689",
    "uuid": "5ce9f1c1-5e7e-11e4-8e76-00259",
    "match": "exact", # similar, common_parts, part_of, covers, chaos, citings
    "match_rate": "0.998", # 0..1 floating point number
    "title": "Приключения незнайки на луне",
    "meta_trust": "trusted", # trusted, user_upload
    "copyright": "protected", # free, public_domain, unknown
    "url": "http://www.litres.ru/nikolay-nosov/priklucheniya-neznayki-i-ego-druzey-1/",
    "price": "56.40",
    "subtitle": "внезапные и отчаянные",
    "chars": "100500",
    "sequence": "Незнайка и его друзья",
    "persons": [
		{"link": "author", "id":"5654", "uuid": "62b25fe3-5b5b-11e4-96e2-0025905a06ea", "title": "Игорь Носов"},
		{"link": "translator", "id":"5655", "uuid": "62b25fe3-5b5b-11e4-96e2-0025905a08ea", "title": "Владимир Ульянов (Ленин)"},
    ]},{
    "id": "56889",
    "uuid": "5ce9f1c1-5e7e-11e4-8e76-00259",
    "match": "part_of",
    "match_rate": "0.3",
    "meta_trust": "user_upload",
    "title": "Приключения незнайки и его друзей (сборник)",
    "copyright": "unknown",
    "url": "http://www.litres.ru/nikolay-nosov/whatever/",
    "price": "-1",
    "subtitle": "внезапные и отчаянные",
    "chars": "100500",
    "persons": [{"link": "author", "id":"5654", "uuid": "62b25fe3-5b5b-11e4-96e2-0025905a06ea", "title": "Игорь Носов"}]
    }
  ]
}

Comments:

Про модуль Text::Distill здесь https://gribuser.livejournal.com/2597.html

Posted by kurashova at Jan 31, 2018 20:42