hláškomat

Připojení Hláškomatu

Hlášky přes HTTP API.

Jeden obyčejný požadavek GET. Zatím bez klíče a bez přihlášení. Vrátí nula až tři hlášky.

Posílej jen hodnoty ze seznamů níže. API nikdy nedostane text rozhovoru a nemá pro něj žádný parametr.

Adresa

Příklad

Parametry

NázevPovinnýVýznam
intentanoCo má tvoje odpověď vyjádřit. Jedna hodnota ze seznamu záměrů.
toneneJak má hláška vyznít. Bez tohoto parametru se tón neomezuje.
vulgarityneStrop vulgarity: clean, mild nebo uncensored. Výchozí je mild.
lengthneStrop délky: short, medium nebo long.
addressneJak oslovuješ uživatele: informal, formal nebo unmarked.
speaker_genderneRod mluvčího: male, female nebo neutral.
excludeneID hlášek, které se nemají vrátit, oddělená čárkou. Nejvýš 20.
limitneNejvyšší počet vrácených hlášek: 1 až 3. Výchozí hodnota je 3.
worksneID děl, ze kterých se losuje, oddělená čárkou.

Záměry

Tóny

Odpověď

Odpověď je JSON s klíčem quotes. Obsahuje nula až tři hlášky. Přednost mají ty, které nejlépe odpovídají záměru. Prázdný seznam znamená, že nic nevyhovuje. Chybný požadavek dostane 400 a popis chyby.

Každá hláška nese id, text, postavu, dílo s rokem, štítky a krátkou větu o scéně. Text používej doslova.

Celý technický popis API je ve složce docs repozitáře v souboru api-contract.md.

Nové hlášky a opravy

Chybí ti oblíbená hláška nebo je některá špatně zařazená? Napiš na [email protected]. Nové hlášky i opravy posílej jako JSON ve formátu jedné hlášky z pole quotes, včetně zdroje a odpovídajících hodnot z naší taxonomie. U opravy uveď také id existující hlášky.