语言参数规范

SteamData Connect API 和 MCP 工具都支持统一的语言参数规范。所有涉及语言参数的接口都支持以下三种格式。

支持的格式

1. 标准名称 - 首选格式，AI 默认使用

   • 示例：English, Chinese (Simplified), Japanese

2. BCP 47 语言码 - 国际标准语言代码

   • 示例：en-US, zh-CN, ja-JP

3. Steam API 码 - Steam 平台内部使用的代码

   • 示例：english, schinese, japanese

完整语言映射表

标准名称	BCP 47 码	Steam API 码
English	en, en-US, en-GB	english
Chinese (Simplified)	zh, zh-CN, zh-Hans	schinese
Chinese (Traditional)	zh-TW, zh-HK, zh-Hant	tchinese
Japanese	ja, ja-JP	japanese
Korean	ko, ko-KR	koreana
Thai	th, th-TH	thai
French	fr, fr-FR	french
German	de, de-DE	german
Spanish-Spain	es, es-ES	spanish
Spanish-Latin America	es-419, es-MX, es-AR	latam
Russian	ru, ru-RU	russian
Portuguese	pt, pt-PT	portuguese
Portuguese-Brazil	pt-BR	brazilian
Italian	it, it-IT	italian
Polish	pl, pl-PL	polish
Turkish	tr, tr-TR	turkish
Arabic	ar, ar-SA, ar-AE	arabic
Bulgarian	bg, bg-BG	bulgarian
Czech	cs, cs-CZ	czech
Danish	da, da-DK	danish
Dutch	nl, nl-NL	dutch
Finnish	fi, fi-FI	finnish
Greek	el, el-GR	greek
Hungarian	hu, hu-HU	hungarian
Indonesian	id, id-ID	indonesian
Norwegian	no, nb, nb-NO	norwegian
Romanian	ro, ro-RO	romanian
Swedish	sv, sv-SE	swedish
Ukrainian	uk, uk-UA	ukrainian
Vietnamese	vi, vi-VN	vietnamese

使用说明

• 所有格式均支持大小写不敏感匹配
• 系统会自动将输入的语言参数转换为对应的标准格式
• 在 API 文档中,语言参数通常标记为 language 或 lang
• 在 MCP 工具中,语言参数会在工具描述中说明

示例

API 调用示例

# 使用标准名称
curl "https://endpoint.steamdata.ai/api/v1/games/570/localized?language=Chinese%20(Simplified)"

# 使用 BCP 47 码
curl "https://endpoint.steamdata.ai/api/v1/games/570/localized?language=zh-CN"

# 使用 Steam API 码
curl "https://endpoint.steamdata.ai/api/v1/games/570/localized?language=schinese"

MCP 工具示例

当使用 MCP 工具时,可以使用任意支持的格式:

请获取 Dota 2 (App ID: 570) 的中文简体名称和描述

AI 会自动使用标准名称 Chinese (Simplified) 或其他支持的格式。