Найти строки
Поиск по тексту книги: ё = е, без ударений.
GET /books/{book_id}/search · чтение
Ищет фразу или все слова в одной строке. До 200 совпадений.
Параметры пути
| Параметр | Что это |
|---|---|
book_id |
Id книги |
Параметры запроса
| Параметр | Тип | Что это |
|---|---|---|
q |
строка | Что искать |
Что в ответе
| Поле | Что это |
|---|---|
hits[] |
segment_id, chapter_id, chapter_no, line — номер строки в главе, text |
total |
Сколько найдено |
curl "https://golosar-kniga.tech/api/v1/books/$BOOK_ID/search?q=ветер" \
-H "x-api-key: $KEY"
import os, requests
API = "https://golosar-kniga.tech/api/v1"
H = {"x-api-key": os.environ["GOLOSAR_KEY"]}
book_id = "01a134d0-dd73-77be-aa8d-0944ffb2b5e3"
r = requests.get(f"{API}/books/{book_id}/search", headers=H, params={"q": "ветер"})
r.raise_for_status()
print(r.json())
const API = "https://golosar-kniga.tech/api/v1";
const H = { "x-api-key": process.env.GOLOSAR_KEY };
const bookId = "01a134d0-dd73-77be-aa8d-0944ffb2b5e3";
const r = await fetch(`${API}/books/${bookId}/search?q=${encodeURIComponent("ветер")}`, { headers: H });
if (!r.ok) throw new Error(await r.text());
console.log(await r.json());
json Ответ 200
{
"q": "ветер",
"hits": [
{
"segment_id": "01a134d0-ddbf-73ed-9fa8-ecf3089fbbbf",
"chapter_id": "01a134d0-ddb7-72aa-b96c-967b596362fe",
"chapter": "Глава 1",
"chapter_no": 1,
"line": 1,
"text": "Вечер был тих, и только ветер шумел в саду."
}
],
"total": 1,
"chapters": 1
}