开发者
Namesome 有一个很小的 API,程序可以用它随机点名、分组、发布转盘,或者做一次事后任何人都能复核的抽签。
它能做什么
五个端点,各做一件事:从名单里选出中选者、把名单分成人数均衡的小组、把名单发布成一个共享转盘、做一次带公开记录的抽签,以及把那条记录读回来复核。每个成功的响应都带一个人能打开的页面链接,所以用过它的助手可以把过程摊开给人看。
和其他一切一样,免费
没有付费档位,没有账单,也不用银行卡。密钥免费,随账户一起发放,而账户就是一个邮箱地址加一条链接——没有密码。这里没有任何东西会记进账单;下面的限额只是为了让一个调用方不至于把全天的额度替所有人用光。
获取密钥
在账户页面登录并按下按钮。密钥只显示一次,因为我们只保存它的指纹——请当场复制。用 Authorization: Bearer 请求头发送它。你可以同时持有多把密钥,给它们起名以便知道哪个程序拿的是哪一把,也可以随时吊销其中任何一把。
限额
不带密钥:每个地址每天 60 次调用。带密钥:每个账户每天 5000 次调用,无论持有多少把密钥。两个窗口都在 UTC 零点重置。超出额度后返回 429,并附一个说明还要等多少秒的响应头。
它不是赌博工具
它从不经手金钱。任何语言的任何角落都没有券、没有报名费、没有奖品、没有中奖概率,将来也不会有——经手这些的工具会是另一个产品、另一种执照。请用它在你已有的名单里公平地做出选择。
条款
适用于页面的条款同样适用于 API,另加三条:不得用于赌博、不得用于骚扰、不得用于宣扬暴力或自我伤害;限额可能不经通知而改变;而且完全没有服务水平承诺,所以不要在它上面搭建任何要紧的东西。
版本与变更
版本写在路径里。会让调用方出错的变更会作为新版本发布,而不是改动这一版;已退役的版本在此处宣布退役后仍至少继续应答六个月。响应里随时可能出现新字段,读取时请放宽。
MCP 服务器
会说 Model Context Protocol 的助手不必自己写 HTTP 就能做这些事。服务器只有一个地址,一次请求一条消息,没有需要开启或关闭的会话,并提供四个工具:选出中选者、分组、发布转盘,以及复核别人做过的抽签。它消耗的密钥和每天调用次数与端点相同,所以你能做什么并不因为走哪扇门而改变。下面的工具名是协议的一部分,因此是英文的。
POST /mcp
pick_winner
make_teams
create_wheel
verify_draw参考
每个端点、它的字段,以及它可能给出的响应。同一件事的机器可读描述在一个文件里: