泰国法律数据 API 与 MCP
返回泰国法律的条文(按条号)、适用于所述情形的条款、解释这些条款的最高法院判决,或带引用的问题解答。
- v1.0
- 运行中
- 基准报告 (PDF)
输入
- law
- ประมวลกฎหมายอาญา
- section
- 335
- with_deka
- true
输出GET /v3/store/data/thai-legal/section
{
"found": true,
"law": "ประมวลกฎหมายอาญา",
"section": "335",
"text": "ผู้ใดลักทรัพย์
(๑) ในเวลากลางคืน
...",
"deka": [
{ "case_id": "600/2544", "year_be": 2544,
"headnote": "เมื่อผู้เสียหายเห็นจำเลยทั้งสองกำลังลักเอามะม่วง...",
"official_url": "https://deka.supremecourt.or.th" }
]
}全部字段见“响应”一节其他端点:/meta, /laws, /search, /search, /ask 见请求
请求
GET 带查询参数,或按表中注明以 POST 发送 JSON。每次请求 0.1 IC,上线促销期间免费;/meta 与 /laws 始终免费。
请求头
apikeystring必填请求体
lawstring必填/laws 列出的法律名称,用于 /section:ประมวลกฎหมายอาญา。sectionstring必填/section:335。with_dekabooleantrue 时附加引用该条款的最高法院判决。querystring/search 与 /deka/search:"นายจ้างเลิกจ้างลูกจ้างต้องจ่ายค่าชดเชยเท่าไร"。cites_lawcites_sectionstring/deka/search:仅限引用该条款的判决,法律用法院缩写,如 ป.อ. 与 335。year_fromtop_kintegerquestioninclude_dekastring, boolean/ask:泰语问题,以及是否同时检索判决。| 端点 | 作用 | 价格 |
|---|---|---|
GET /v3/store/data/thai-legal/meta | 已索引的内容,以及已知缺失 | 免费 |
GET …/laws、GET …/laws?law= | 法律目录;某部法律的全部条款编号 | 免费 |
GET …/section | 一条 原文 | 0.1 IC |
GET 或 POST …/search | 适用于某情形的条款,600 字符摘要 | 0.1 IC |
GET 或 POST …/deka/search | 关于某情形或条款的判决,按裁判要旨检索 | 0.1 IC |
GET …/deka/{case_id} | 一份判决,1234/2565 或 1234-2565;include=body 附最多 4,000 字符正文 | 0.1 IC |
POST …/ask | 有依据、带引用的答案 | 0.1 IC |
在 AI 智能体中使用
添加远程服务器 https://mcp.iapp.co.th 并用 iApp 账户登录,无需复制密钥。Claude:打开 Settings、Connectors、Add custom connector,命名为 iApp AI 并粘贴 URL;Claude Code:运行 claude mcp add --transport http iapp-ai https://mcp.iapp.co.th;其他客户端见 MCP 服务器指南。本地运行:uvx iapp-mcp,并在环境中设置 IAPP_API_KEY,密钥留在您的机器上。工具调用与 REST 调用同样计费。
| 工具 | 参数 | 作用 |
|---|---|---|
iapp_thai_law_list | q | 法律目录,免费;先调用以获得有效法律名 |
iapp_thai_law_section | law、section、with_deka | 条款原文 |
iapp_thai_law_search | query、top_k | 跨全部条款的语义搜索;适用法律未索引时给出提醒 |
iapp_thai_deka_search | query、cites_law、cites_section、year_from、top_k | 判例搜索 |
iapp_thai_deka_get | case_id、include_body | 一份判决 |
iapp_thai_krisdika_opinion_search | query、top_k | 法制委员会意见,按标题检索,链接官方 PDF |
iapp_thai_admincourt_search | query、court、top_k | 行政法院判决,按标题、当事人或案号检索,链接官方 PDF |
iapp_thai_legal_ask | question、include_deka | 有依据的答案 |
然后用泰语提问,例如 "ลักทรัพย์ในเวลากลางคืนมีโทษอย่างไร อ้างมาตราและฎีกาให้ด้วย"、"หาฎีกาที่ตีความ ป.อ. มาตรา 335 หลังปี 2560"。
响应
右侧面板为 /section 的响应;仅在部分结果中出现的字段,会在说明中注明何时出现。
in_forcestringcurated:属于 39 部法律的整合核心;repealed:法制委员会标记为废止,不进入搜索但可读取;unverified:其余全部。刻意没有"生效"这个值,因为没有标记不能证明任何事:依赖某条款前请核实其仍然有效。citation_join/deka/search 返回的判决上:exact、range 或 none,表示判决与条款关联的置信度coveragestatus: governing_law_not_indexed 及该法律的名称,而不是给出手头最接近的内容grounded/ask 上:未检索到任何内容时为 false,此时不作答。每个引用的判决编号都与检索结果核对;无依据的引用会以更严格的指令重新生成一次,然后拒答。depthmetadata_only:其论证在链接的 PDF 中,命中只是指针,不是裁判要旨foundbooleanfalse 并附 suggestions,仍为 HTTP 200,客户端因此不会重试lawstringsectionstringunitstringchapterstringtextstringdekaarraywith_deka 时:引用该条款的判决,各含 case_id、year_be、headnote 与 official_url低于置信度门槛的搜索返回 count: 0 与 confidence 说明,而非看似合理的填充。
详情
实测
2026 年 10 月 28 日在生产环境测得,使用公开的 NitiBench 泰国金融与商法基准,检索范围为 API 收录的全部 2,346 部法律。
| 指标 | 结果 |
|---|---|
| 适用条款位于前 10 个结果中,3,729 道简短问题 | 88.0%(95% CI 87.0–89.1%) |
| 适用条款排第一 / 位于前 5 | 58.4% / 84.3% |
| 答案条款位于前 10 个结果中,50 份税务厅真实裁定(共 131 条) | 22.1%;44.0% 的裁定至少找到一条 |
/section 返回的基准条款 | 3,585 条中 3,585 条 |
| 2014 年以来修订的条款以修订后文本提供 | 154 条中 139 条(基准自身副本:86 条) |
使用 cites_section 返回的判决确实引用该条款 | 94.1%(471 份中 443 份) |
经 API 的中位耗时:/search / /section | 0.88 秒 / 69 毫秒 |
针对单一条款的问题通常在第一页结果中即可找到对应条款;涉及多个条款的冗长案情很少能全部找到,应按争点逐一检索。该基准仅涵盖金融与商法,刑法、劳动法、土地法和行政法未经测量,/ask 亦未评分。方法、按法律细分的结果与限制:基准测试报告 (PDF)。
限制
- 每个账户每秒最多 5 次、每分钟 100 次、每天 1,000 次请求(每天从 UTC 00:00 起算,即曼谷时间 07:00)。超出限制的请求返回
429,响应头X-RateLimit-Remaining-Day显示当天剩余次数。本 API 用于逐条查询和阅读,不允许批量下载语料库,这样做的账户将被暂停。如需更高用量,请联系 sale@iapp.co.th。 - 判决语料并非最高法院全部档案;
/meta报告已索引内容。判例搜索匹配裁判要旨而非案情叙述,且每条要旨返回一条结果,同一判决可能出现多次;请按case_id归并结果。 /section只接受与/laws列出的完全一致的法律名称,以及阿拉伯数字条款号335。泰文数字(๓๓๕)、号码前加 มาตรา、缩写如ป.พ.พ.,或省略年份的法令名称,都会返回found: false,即使该法律已收录。/deka/{case_id}不接受合并案号,如1579-1580/2558,而/deka/search可能返回此类判决;请通过搜索结果中的链接打开。- 2014 年以来修订的 154 条中,有 13 条仍以修订前文本提供,其中 12 条为 2024 年修订的《民商法典》亲属编条款。这些响应均附有注明修订法的警告,依赖文本前请先阅读该警告。
- 法制委员会意见与行政法院判决仅索引到标题层级。
- 不构成法律建议。依赖判决前请到 deka.supremecourt.or.th 核实;每条结果都链接 到那里。错误请报告至 legal@iapp.co.th。
语料库
- 法规:2,346 部法律,68,237 条,佛历 2417 至 2569 年:五部法典、พ.ร.บ.、พ.ร.ก.、พ.ร.ฎ. 与部级规章;其中包括 2560 年宪法,以及劳动、土地、PDPA、计算机、毒品、交通、社会保障、破产和知识产权法律。
- 整合核心:39 部整合文本,与 OpenThai 2.0 Legal 所用相同,优先于任何其他副本。
- 最高法院:133,159 份文书,120,216 份判决及命令与裁定,各附裁判要旨;91,384 个案号,因一份判决可含多条要旨;99.7% 关联到所引条款。
- 法制委员会:6,534 份意见,佛历 2466 至 2569 年。
- 行政法院:全部 16 所法院的 128,361 份判决与命令,以 CC-BY 发布。
依 พ.ร.บ. ลิขสิทธิ์ พ.ศ. 2537 第 7(4) 条,判决和官方报告不属于著作权作品,文本属公共领域;iApp 不代法院认证其内容。
数据处理
查询在内存中处理,响应返回后不保留。依 PDPA 与 GDPR 取得同意并告知当事人,由作为数据控制者的您负责。