API

profanity-check

Возвращает замаскированную копию, фрагменты с пометкой тяжести, счёт по категориям и общий вердикт. Сам словарь оскорблений не раскрывается.

v2 beta server · 1 ток.

Цена (server): 1 ток. за вызов; с Премиумом −5 %, с округлением вверх. Точная сумма для вашего файла: POST /v1/tools/profanity-check/estimate.

Вызов

POST https://timbrica.com/v1/tools/profanity-check/runs
Authorization: Bearer $TIMBRICA_KEY
Idempotency-Key: <ваш ключ для безопасного повтора>
Content-Type: application/json

Вход

ПолеТипОбязательноеПояснение
text string да Текст для проверки.
макс. длина: 50000
strictness string нет slurs — только оскорбления; standard — оскорбления и мат; all — включая эвфемизмы.
одно из: slurs, standard, all
по умолчанию: standard
mode string нет Как маскировать совпадения в возвращаемой копии.
одно из: dot, star, remove, first
по умолчанию: dot
scope string нет
одно из: text, name
по умолчанию: text
categories array нет Искать только в этих категориях. Не передавайте — будут все.

Какие ошибки может вернуть

empty_text  text_too_long  processing_failed 

История

  • v2 — 2026-09-11 — Output schema corrected: `verdict` is an object `{level, accountRisk}`, as the tool has always returned — v1 documented it as a string. No behaviour change.
  • v1 — 2026-07-30 — Initial release.

Контракт не может измениться без новой версии и строки выше: тест сверяет опубликованную схему, цены и лимиты с закоммиченным lock-файлом и иначе роняет сборку. Подпишитесь на /v1/changelog, чтобы узнавать об изменениях.