# Правила ударений и чтения

Как читать слова: в книге и во всех ваших книгах.

`GET /pronunciations` · чтение

С `book_id` — правила этой книги (и её цикла) и общие правила ваших книг; без него — все ваши правила.

## Параметры запроса

| Параметр | Тип | Что это |
|---|---|---|
| `book_id` | строка | Книга |

## Что в ответе

| Поле | Что это |
|---|---|
| `word` / `replacement` | Слово и как его читать (`+` перед ударной гласной) |
| `book_id` | Книга или `null` — для всех ваших книг |

```bash
curl "https://golosar-kniga.tech/api/v1/pronunciations?book_id=01a134d0-dd73-77be-aa8d-0944ffb2b5e3" \
  -H "x-api-key: $KEY"
```

```python
import os, requests

API = "https://golosar-kniga.tech/api/v1"
H = {"x-api-key": os.environ["GOLOSAR_KEY"]}

r = requests.get(f"{API}/pronunciations", headers=H, params={"book_id": "01a134d0-dd73-77be-aa8d-0944ffb2b5e3"})
r.raise_for_status()
print(r.json())
```

```javascript
const API = "https://golosar-kniga.tech/api/v1";
const H = { "x-api-key": process.env.GOLOSAR_KEY };

const r = await fetch(`${API}/pronunciations?book_id=01a134d0-dd73-77be-aa8d-0944ffb2b5e3`, { headers: H });
if (!r.ok) throw new Error(await r.text());
console.log(await r.json());
```

```json Ответ 200
{
  "items": [
    {
      "id": "01a134d0-e73d-7693-a0f4-466923d2ea42",
      "word": "Мира",
      "replacement": "М+ира",
      "book_id": "01a134d0-dd73-77be-aa8d-0944ffb2b5e3",
      "source": "manual",
      "verified": true,
      "note": ""
    }
  ]
}
```