# Добавить правило

Ударение или своё чтение слова.

`POST /pronunciations` · всё

`М+ира` — ударение; `ВВС = вэ-вэ-эс` — своё чтение. С `book_id` правило действует в книге и во всех томах её цикла,
без него — во всех ваших книгах. Озвученные главы со словом станут «изменены после озвучки».

## Тело запроса

JSON, заголовок `content-type: application/json`.

| Поле | Тип | Обязательно | Что это |
|---|---|---|---|
| `word` | строка | да | Слово, как оно написано |
| `replacement` | строка | да | Как читать: с `+` перед ударной гласной |
| `book_id` | строка | нет | Для этой книги; без него — для всех |

```bash
curl -X POST "https://golosar-kniga.tech/api/v1/pronunciations" \
  -H "x-api-key: $KEY" \
  -H "content-type: application/json" \
  -d '{"word": "Мира", "replacement": "М+ира", "book_id": "01a134d0-dd73-77be-aa8d-0944ffb2b5e3"}'
```

```python
import os, requests

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

r = requests.post(f"{API}/pronunciations", headers=H, json={"word": "Мира", "replacement": "М+ира", "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, "content-type": "application/json" };

const r = await fetch(`${API}/pronunciations`, { method: "POST", headers: H, body: JSON.stringify({"word": "Мира", "replacement": "М+ира", "book_id": "01a134d0-dd73-77be-aa8d-0944ffb2b5e3"}) });
if (!r.ok) throw new Error(await r.text());
console.log(await r.json());
```

```json Ответ 200
{
  "id": "01a134d0-e73d-7693-a0f4-466923d2ea42"
}
```