curl -s http://127.0.0.1:8130/v2/healthcheck

OK

curl -s -o /dev/null -w 'HTTP:%{http_code}\n' http://127.0.0.1:8130/health
# HTTP:400
curl -s http://127.0.0.1:8130/health
# Error: This is the LanguageTool API. You have not specified any parameters. Please see https://languagetool.org/http-api/swagger-ui/#/default

curl -s http://127.0.0.1:8130/v2/languages | python3 -c "import json,sys; print(len(json.load(sys.stdin)), '种语言')"
# 60 种语言

curl -s -d "language=en-US" \
  --data-urlencode "text=This are an test of the grammar checker. I didn't knew that." \
  http://127.0.0.1:8130/v2/check

{"software": {"name": "LanguageTool", "version": "6.8", "buildDate": "1980-02-01 00:00:00 +0000",
  "apiVersion": 1, "premium": false,
  "premiumHint": "You might be missing errors only the Premium version can find. Contact us at support<at>languagetoolplus.com.", "status": ""},
 "warnings": {"incompleteResults": false},
 "language": {"name": "English (US)", "code": "en-US",
  "detectedLanguage": {"name": "English (US)", "code": "en-US", "confidence": 0.99, "source": "fasttext"}},
 "matches": [
  {"message": "The singular demonstrative pronoun ‘this’ does not agree with the plural verb ‘are’. Did you mean “these”?",
   "shortMessage": "Grammatical problem: use ‘these’",
   "replacements": [{"value": "These"}],
   "offset": 0, "length": 4,
   "context": {"text": "This are an test of the grammar checker. I d...", "offset": 0, "length": 4},
   "sentence": "This are an test of the grammar checker.",
   "type": {"typeName": "Other"},
   "rule": {"id": "THIS_NNS", "subId": "5", "sourceFile": "grammar.xml",
    "description": "'this' vs. 'these'", "issueType": "grammar",
    "category": {"id": "GRAMMAR", "name": "Grammar"}}, ...},
  {"message": "The verb ‘are’ is plural. Did you mean: “is”?...", "rule": {"id": "PLURAL_VERB_AFTER_THIS", ...}, "offset": 5, ...},
  {"message": "Use “a” instead of ‘an’ if the following word doesn’t start with a vowel sound...",
   "rule": {"id": "EN_A_VS_AN", "subId": "1", "sourceFile": "grammar.xml", "issueType": "grammar",
    "category": {"id": "MISC", "name": "Miscellaneous"}}, ...},
  {"message": "Did you mean “know”?...", "rule": {"id": "AUXILIARY_DO_WITH_INCORRECT_VERB_FORM", ...}, ...}],
 "sentenceRanges": [[0, 40], [41, 60]],
 "extendedSentenceRanges": [{"from": 0, "to": 40, "detectedLanguages": [{"language": {"code": "en-US"}, "rate": 1.0}]}, ...]}

curl -s -G http://127.0.0.1:8130/v2/check \
  --data-urlencode "language=en-US" \
  --data-urlencode "text=This are a test of the grammar checker." \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print([m['rule']['id'] for m in d['matches']])"

['THIS_NNS', 'PLURAL_VERB_AFTER_THIS']

curl -s -d "language=auto" \
  --data-urlencode "text=Guten Tag, wie geht es Ihnen heute?" \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print(json.dumps(d['language'], ensure_ascii=False)); print('matches:', len(d['matches']))"

{"name": "German (Germany)", "code": "de-DE", "detectedLanguage": {"name": "German (Germany)", "code": "de-DE", "confidence": 0.99, "source": "fasttext"}}
matches: 0

curl -s -d "language=xx" -d "text=hello" http://127.0.0.1:8130/v2/check -w "\nHTTP:%{http_code}\n"

Error: 'xx' is not a language code known to LanguageTool. Supported language codes are: ar, ast-ES, be-BY, ... zh-CN. The list of languages is read from META-INF/org/languagetool/language-module.properties in the Java classpath. See https://dev.languagetool.org/java-api for details.
HTTP:400

Error: Missing 'language' parameter, e.g. 'language=en-US' for American English or 'language=fr' for French

Error: Unknown value 'PICKY' for parameter 'level'. Valid values: default, picky, academic, clarity, professional, creative, customer, jobapp, objective, elegant

curl -s -d "language=en-US" -d "level=picky" \
  --data-urlencode "text=We discussed about the problem." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print([(m['rule']['id'], m['replacements']) for m in d['matches']])"

[('MENTION_ABOUT', [{'value': 'discussed the'}])]

curl -s -d "language=en-US" -d "level=picky" \
  --data-urlencode "text=The reason is because it was raining." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print([(m['rule']['id'], m['replacements']) for m in d['matches']])"

[('REASON_IS_BECAUSE', [{'value': 'is that'}])]

Error: You specified 'preferredVariants' but you didn't specify 'language=auto'

curl -s -d "language=auto" -d "preferredVariants=en-GB" \
  --data-urlencode "text=The color of the sweater is my favorite." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['language']['code'], [(m['rule']['id'], [r['value'] for r in m['replacements']]) for m in d['matches']])"

en-GB [('MORFOLOGIK_RULE_EN_GB', ['colour']), ('EN_GB_SIMPLE_REPLACE_SWEATER', ['jumper']), ('MORFOLOGIK_RULE_EN_GB', ['favourite'])]

curl -s -d "language=auto" -d "preferredVariants=en-US" \
  --data-urlencode "text=The colour of the sweater is my favourite." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['language']['code'], [(m['rule']['id'], [r['value'] for r in m['replacements']]) for m in d['matches']])"

en-US [('MORFOLOGIK_RULE_EN_US', ['color']), ('MORFOLOGIK_RULE_EN_US', ['favorite'])]

curl -s -d "language=en-US" -d "motherTongue=de" \
  --data-urlencode "text=I didn't knew that." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print([(m['rule']['id'], [r['value'] for r in m['replacements']]) for m in d['matches']])"

[('AUXILIARY_DO_WITH_INCORRECT_VERB_FORM', ['know'])]

curl -s -d "language=en-US" --data-urlencode "text=This are a test." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print([m['rule']['id'] for m in json.load(sys.stdin)['matches']])"
# ['THIS_NNS', 'PLURAL_VERB_AFTER_THIS']

curl -s -d "language=en-US" -d "disabledRules=THIS_NNS" \
  --data-urlencode "text=This are a test." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print([(m['rule']['id'], m['offset']) for m in json.load(sys.stdin)['matches']])"
# [('PLURAL_VERB_AFTER_THIS', 0)]

curl -s -d "language=en-US" -d "enabledRules=THIS_NNS" -d "enabledOnly=true" \
  --data-urlencode "text=This are a very big mistake. teh" \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print([(m['rule']['id'], m['offset']) for m in json.load(sys.stdin)['matches']])"
# [('THIS_NNS', 0)]

curl -s -d "language=en-US" \
  --data-urlencode "text=I buyed a book yesterday and i readed it." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print([(m['rule']['id'], m['rule']['category']['id']) for m in json.load(sys.stdin)['matches']])"
# [('MORFOLOGIK_RULE_EN_US', 'TYPOS'), ('MORFOLOGIK_RULE_EN_US', 'TYPOS')]

curl -s -d "language=en-US" -d "disabledCategories=TYPOS" \
  --data-urlencode "text=I buyed a book yesterday and i readed it." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print('matches:', json.load(sys.stdin)['matches'])"
# matches: []

curl -s -d "language=en-US" -d "offset=0" -d "length=15" \
  --data-urlencode "text=This are a test. teh end is near." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print([(m['rule']['id'], m['offset']) for m in json.load(sys.stdin)['matches']])"

[('THIS_NNS', 0), ('PLURAL_VERB_AFTER_THIS', 5), ('MORFOLOGIK_RULE_EN_US', 17)]

curl -s -d "language=de-LU" \
  --data-urlencode "text=Der hund läuft schnell über die strasse." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['language']['code'], d.get('detectedLanguage'), len(d['matches']))"
# de {'name': 'German (Germany)', 'code': 'de-DE', 'confidence': 0.924, 'source': 'fasttext'} 0

curl -s http://127.0.0.1:8130/v2/languages

[{"name":"Arabic","code":"ar","longCode":"ar"},
 {"name":"Asturian","code":"ast","longCode":"ast-ES"},
 {"name":"Belarusian","code":"be","longCode":"be-BY"},
 ...
 {"name":"Chinese","code":"zh","longCode":"zh-CN"},
 {"name":"Dutch","code":"nl","longCode":"nl"},
 {"name":"Dutch (Belgium)","code":"nl","longCode":"nl-BE"},
 {"name":"Dutch","code":"nl","longCode":"nl-NL"},
 ...
 {"name":"English (US)","code":"en-US","longCode":"en-US"}]

curl -s -d "language=en-US" \
  --data-urlencode "text=This are a test. teh end is near." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print([(m['rule']['id'], m['offset'], m['length']) for m in json.load(sys.stdin)['matches']])"

[('THIS_NNS', 0, 4), ('PLURAL_VERB_AFTER_THIS', 5, 3), ('MORFOLOGIK_RULE_EN_US', 17, 3)]

for t in "我在公司上班，注要负责产品测试工作。" "因为我昨天看了电影，所依很晚才睡觉。" "他的建议对我启发很大，我觉的非常有道理。"; do
  echo "### $t"
  curl -s -d "language=zh-CN" --data-urlencode "text=$t" http://127.0.0.1:8130/v2/check \
    | python3 -c "import json,sys; d=json.load(sys.stdin); print([(m['rule']['id'], m['offset']) for m in d['matches']] or '(0 matches)')"
done

### 我在公司上班，注要负责产品测试工作。
(0 matches)
### 因为我昨天看了电影，所依很晚才睡觉。
(0 matches)
### 他的建议对我启发很大，我觉的非常有道理。
(0 matches)

curl -s -d "language=de-DE" \
  --data-urlencode "text=Der hund läuft schnell über die strasse." \
  http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print([(m['rule']['id'], m['offset'], m['replacements']) for m in json.load(sys.stdin)['matches']])"

[('GERMAN_SPELLER_RULE', 4, [{'value': 'Hund'}, {'value': 'und'}]), ('GERMAN_SPELLER_RULE', 29, [{'value': 'Straße'}, {'value': 'Ostrasse'}])]

curl -s -d "language=zh-CN" -d "text=teh quick brown fox" http://127.0.0.1:8130/v2/check \
  | python3 -c "import json,sys; print('matches:', len(json.load(sys.stdin)['matches']))"
# matches: 0

for i in 1 2 3 4; do curl -s -o /dev/null -w "第${i}次: HTTP:%{http_code}\n" \
  -d "language=en-US" -d "text=hello world" http://127.0.0.1:8130/v2/check; done

第1次: HTTP:200
第2次: HTTP:200
第3次: HTTP:200
第4次: HTTP:429

Error: Access from 10.89.56.1 denied: Client request limit of 3 requests per 60 seconds exceeded

Error: Your text exceeds the limit of 1000 characters (it's 1200 characters). Please submit a shorter text.

languagetool-6.8-server: 711.2MiB / 19.48GiB  0.18%

docker logs languagetool-6.8-server 2>&1 | grep 'Using JAVA_OPTS'
# INFO: Using JAVA_OPTS=-Xms256m -Xmx512m -XX:+UseG1GC -XX:+UseStringDeduplication

ps -ef | grep '[H]TTPServer'

783       323948  323872  1 09:55 ?        00:00:11 java -Xms256m -Xmx512m -XX:+UseG1GC -XX:+UseStringDeduplication -Djna.tmpdir=/tmp -Dlogback.configurationFile=/tmp/logback.xml -cp .:languagetool-server.jar org.languagetool.server.HTTPServer --port 8081 --public --allow-origin * --config /tmp/config.properties

docker logs languagetool-6.8-server 2>&1 | grep 'Handled request' | tail -3

2026-10-28 02:05:33 +0000 Handled request in 42ms; sending code 200

cd /opt/languagetool
docker compose ps                          # 实例状态（含 healthy）
docker compose logs -f languagetool        # 跟随日志
docker compose restart languagetool        # 重启（配置文件不重读）
docker compose up -d --force-recreate      # 配置变更后重建（环境变量重读的唯一方式）