Разлика между версии на „API“

От Уики на Читанка
Направо към: навигация, търсене
(Нова страница: Съществуват търсачки за основните обекти в библиотеката. За изходен формат се използва XML. * ...)
 
м
 
(Не са показани 5 междинни версии от 2 потребители)
Ред 1: Ред 1:
 +
'''Статията е пренесена в новото уики.'''
 +
 +
== Търсене ==
 +
 
Съществуват търсачки за основните обекти в библиотеката. За изходен формат се използва XML.
 
Съществуват търсачки за основните обекти в библиотеката. За изходен формат се използва XML.
* книги: http://chitanka.info/books/search.xml?q=query
+
 
* творби: http://chitanka.info/texts/search.xml?q=query
+
Общи параметри:
* личности: http://chitanka.info/books/search.xml?q=query
+
; q
* авторски поредици: http://chitanka.info/series/search.xml?q=query
+
: какво се търси
* издателски поредици: http://chitanka.info/sequences/search.xml?q=query
+
: задължителен; минимум четири знака
 +
; by
 +
: къде да се търси
 +
: незадължителен
 +
; match
 +
: как да се търси
 +
: за стойност едно от {prefix, suffix, exact}; по подразбиране празно, което е равносилно на prefix или suffix; ако се посочи <code>exact</code>, отпада ограничението за дължината на заявката
 +
 
 +
=== Глобално търсене ===
 +
 
 +
http://chitanka.info/search.xml?q=query
 +
 
 +
При глобалното търсене се използва само параметърът <code>q</code>.
 +
 
 +
=== Книги ===
 +
http://chitanka.info/books/search.xml?q=query
 +
 
 +
; by
 +
: за стойност един или повече елемента от {id, title, subtitle, orig_title}, свързани с „,“; по подразбиране „title,subtitle,orig_title“
 +
 
 +
Пример: http://chitanka.info/books/search.xml?q=fant&by=title,orig_title&match=prefix
 +
 
 +
=== Творби ===
 +
http://chitanka.info/texts/search.xml?q=query
 +
 
 +
; by
 +
: за стойност един или повече елемента от {id, title, subtitle, orig_title, orig_subtitle}, свързани с „,“; по подразбиране „title,subtitle,orig_title“
 +
 
 +
Пример: http://chitanka.info/texts/search.xml?q=666&by=id&match=exact
 +
 
 +
=== Личности ===
 +
http://chitanka.info/persons/search.xml?q=query
 +
 
 +
; by
 +
: за стойност един или повече елемента от {id, slug, name, orig_name, real_name, oreal_name}, свързани с „,“; по подразбиране „name,orig_name“
 +
 
 +
=== Авторски поредици ===
 +
http://chitanka.info/series/search.xml?q=query
 +
 
 +
; by
 +
: за стойност един или повече елемента от {id, slug, name, orig_name}, свързани с „,“; по подразбиране „name,orig_name“
 +
 
 +
=== Издателски поредици ===
 +
http://chitanka.info/sequences/search.xml?q=query
 +
 
 +
; by
 +
: за стойност един или повече елемента от {id, slug, name}, свързани с „,“; по подразбиране „name“

Текуща версия към 17:42, 4 октомври 2015

Статията е пренесена в новото уики.

Търсене

Съществуват търсачки за основните обекти в библиотеката. За изходен формат се използва XML.

Общи параметри:

q
какво се търси
задължителен; минимум четири знака
by
къде да се търси
незадължителен
match
как да се търси
за стойност едно от {prefix, suffix, exact}; по подразбиране празно, което е равносилно на prefix или suffix; ако се посочи exact, отпада ограничението за дължината на заявката

Глобално търсене

http://chitanka.info/search.xml?q=query

При глобалното търсене се използва само параметърът q.

Книги

http://chitanka.info/books/search.xml?q=query

by
за стойност един или повече елемента от {id, title, subtitle, orig_title}, свързани с „,“; по подразбиране „title,subtitle,orig_title“

Пример: http://chitanka.info/books/search.xml?q=fant&by=title,orig_title&match=prefix

Творби

http://chitanka.info/texts/search.xml?q=query

by
за стойност един или повече елемента от {id, title, subtitle, orig_title, orig_subtitle}, свързани с „,“; по подразбиране „title,subtitle,orig_title“

Пример: http://chitanka.info/texts/search.xml?q=666&by=id&match=exact

Личности

http://chitanka.info/persons/search.xml?q=query

by
за стойност един или повече елемента от {id, slug, name, orig_name, real_name, oreal_name}, свързани с „,“; по подразбиране „name,orig_name“

Авторски поредици

http://chitanka.info/series/search.xml?q=query

by
за стойност един или повече елемента от {id, slug, name, orig_name}, свързани с „,“; по подразбиране „name,orig_name“

Издателски поредици

http://chitanka.info/sequences/search.xml?q=query

by
за стойност един или повече елемента от {id, slug, name}, свързани с „,“; по подразбиране „name“