rskmoi/namedivider-api

NameDivider API 🦒

⚠️ 重要通知：REST API 实现已迁移至 https://github.com/rskmoi/namedivider-rs%EF%BC%8C%E4%BB%A5%E8%BF%9B%E8%A1%8C%E8%BF%9B%E4%B8%80%E6%AD%A5%E5%BC%80%E5%8F%91%E5%92%8C%E6%80%A7%E8%83%BD%E6%94%B9%E8%BF%9B%E3%80%82

🆚 旧版 Python API

之前基于 Python 的 API 位于 ./old/ 目录中，仅用于向后兼容。但我们强烈建议使用新的基于 Rust 的 API，以获得更好的性能和可靠性：

• 与 Python 实现相比，批处理能力提升高达 10 倍
• 增强的 GBDT 算法带来更高的准确率
• 与原始 Python API (v0.1.0) 兼容

---

当前基于 Rust 的 API（推荐）

一个高性能 REST API，用于将日文全名分割为姓和名，基于 Rust 构建以实现最高效率。

🚀 快速开始

安装

bash
docker pull rskmoi/namedivider-api:0.3.0

运行 API 服务器

bash
docker run -d -p 8000:8000 rskmoi/namedivider-api:0.3.0

发送 HTTP 请求

使用 BasicNameDivider

bash
curl -X POST -H "Content-Type: application/json" -d '{"names":["竈門炭治郎", "竈門禰豆子"]}' localhost:8000/divide

或

bash
curl -X POST -H "Content-Type: application/json" -d '{"names":["竈門炭治郎", "竈門禰豆子"], "mode": "basic"}' localhost:8000/divide

使用 GBDTNameDivider

bash
curl -X POST -H "Content-Type: application/json" -d '{"names":["竈門炭治郎", "竈門禰豆子"], "mode": "gbdt"}' localhost:8000/divide

响应

json
{
    "divided_names":
        [
            {"family":"竈門","given":"炭治郎","separator":" ","score":0.3004587452426102,"algorithm":"kanji_feature"},
            {"family":"竈門","given":"禰豆子","separator":" ","score":0.30480429696983175,"algorithm":"kanji_feature"}
        ]
}

🎯 特性

两种分割算法

核心能力

• 🔥 高性能：基于 Rust 构建，实现最大吞吐量
• 📦 容器化：即开即用的 Docker 镜像
• 🌍 多语言支持：提供 7 种以上编程语言的客户端示例
• ⚡ 批处理：每次请求最多可处理 1,000 个姓名
• 🎯 高准确率：GBDT 算法准确率达 99.9%
• 🔧 易于集成：RESTful API，支持 JSON 请求/响应

📡 API 端点

POST /divide

将日文全名分割为姓和名。

请求体：

json
{
  "names": ["竈門炭治郎", "竈門禰豆子"],
  "mode": "basic"
}

响应：

json
{
    "divided_names":
        [
            {"family":"竈門","given":"炭治郎","separator":" ","score":0.3004587452426102,"algorithm":"kanji_feature"},
            {"family":"竈門","given":"禰豆子","separator":" ","score":0.30480429696983175,"algorithm":"kanji_feature"}
        ]
}

参数：

• names（必填）：未分割的日文姓名数组（最多 1,000 项）
• mode（可选）：分割算法 - "basic"（默认）或 "gbdt"

响应字段：

• family：姓部分
• given：名部分
• separator：分隔符（固定为 " "）
• score：置信度分数（0.0 - 1.0）
• algorithm：使用的分割算法

🛠️ 客户端库

我们提供多种编程语言的极简客户端示例，包括 TypeScript/JavaScript、Python、Go、PHP、Ruby、C# 和 Kotlin。

有关详细示例和实现代码，请参见：https://github.com/rskmoi/namedivider-rs/tree/main/api/client-samples