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

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

POST /pronunciations · всё

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

Тело запроса

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

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

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())

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" }