更新日志

Atom 订阅源 · 版本与兼容性

2026年11月

“使用 Vimine 登录”打开登录页面

2026年11月13日 · WordPress 插件 0.1.7 · 修复

“使用 Vimine 登录”现在将会员带到 Vimine 的登录页面 /authorize：此前它打开的是 Vimine 并不提供的地址，会员无法从网站登录。

→ WordPress 插件

托管页面的主要按钮

2026年11月12日 · 托管页面 · 变更

在入会表单及其确认页面、“使用 Vimine 登录”和活动页面（/agenda/…）中，主要按钮不再是实心填充或仅有边框：它采用强调色的浅色底，文字为同一颜色，与 Vimine 其他部分一致。表单的参数（scheme、accent、background、font）和 API 均无变化。

→ 嵌入与会员卡核验

附件 3 的历史版本保持发布时的内容

2026年11月7日 · API · 修复

GET /v1/legal/{kind} 现在按版本发布时的登记表（即 data 中的那份）而非今天的登记表来呈现已发布或已撤回的子处理者清单版本（aps_dpa_annex3_subprocessors，包括带 version 的请求）：此前登记表的每次变更都会改写所有版本的表格，包括现行版本。

→ GET /v1/legal/{kind}

协会的公开文件

2026年11月6日 · API · 新增

GET /v1/aps/{slug}/documents 列出协会在其文件库中公开的文件——成立章程、旧版章程、其他文书——包括类型、标题、日期和原件地址；GET /v1/aps/{slug}/documents/{uid} 以 302 跳转到一个十五分钟内有效的原件链接：需要时再请求，不要保存。会议记录和财务报表绝不公开。两者仅在协会开放在线入会或启用 API 时可用，与规章相同。

→ GET /v1/aps/{slug}/documents

未成年人的年龄也从税号读取

2026年11月6日 · API · 修复

缺少 dob 时，POST /v1/enroll 现在也会从 codicefiscale 读取年龄，与其他入会途径一致：对仅凭税号识别的未成年人，如协会收集行使父母责任的人的信息，请求将返回 422，guardian 上为 required；此前该请求无需这些信息即可通过。托管的入会表单在同样情况下也会要求填写。

→ POST /v1/enroll

2026年10月

托管页面的字体可以加载了

2026年10月30日 · 托管页面 · 修复

网站为嵌入式入会表单指定的字体（font）以及应用在登录页面上的字体现在都能加载了：此前字体文件请求的是错误的地址，每种字体都退回到了通用字体族。

→ 嵌入与会员卡核验

沙盒显示协会的图片

2026年10月30日 · API · 修复

协会的图片及其适用的背景现在会同步到协会的沙盒：此前沙盒的 GET /v1/aps/{slug} 和测试客户端的登录页面显示的是沙盒创建当天的图片，或者没有图片。

→ 沙盒与测试客户端

入会表单采用主题的颜色

2026年10月29日 · WordPress 插件 0.1.6 · 新增

主题声明了样式时（区块主题都会声明），入会表单会自动采用主题的背景和按钮颜色，表单提供该字体时也采用主题的字体；否则显示为浅色，而以前会以深色打开。“设置 → Vimine”可为整个站点设置这些选项，[vimine_enroll] 的 scheme、accent、background 和 font 属性或区块的“外观”面板可单独设置某个表单。

→ WordPress 插件

区块改用当前版本的区块 API

2026年10月29日 · WordPress 插件 0.1.6 · 修复

四个区块改用 WordPress 6.9 要求的区块 API 第 3 版：编辑器不再警告它们可能让编辑器无法在 iframe 中运行。

→ WordPress 插件

即将举行的活动不再缺失

2026年10月29日 · API · 修复

使用 filter=upcoming（默认值）时，GET /v1/aps/{slug}/events 和 GET /v1/events 会把已结束的活动也计入 limit：过往活动较多的协会收到的即将举行的活动会变少，甚至一个也没有。现在 limit 只计算筛选条件返回的活动；filter=past 同样如此。

→ GET /v1/aps/{slug}/events

活动页面显示更多信息

2026年10月29日 · 托管页面 · 变更

在 Vimine 上的活动公开页面（/agenda/…）中，每种报名类型都会显示其说明，已取消的活动会显示协会填写的取消原因；已取消或已结束的活动不再列出报名类型。

→ 活动与报名

令牌会注明协会

2026年10月29日 · API · 新增

/v1/oauth/token 的响应（authorization_code 和 refresh_token 授权）包含 aps：会员登录所在协会的 slug、name 和 picture_url，无需再次调用即可显示协会名称和标志。

→ POST /v1/oauth/token

银行卡和支票付款

2026年10月29日 · API · 新增

报名的 payment.method 是开放字符串，现在也可能是 card（协会手动登记的刷卡终端或付款链接）或 cheque。遇到不认识的值时，请按通用付款方式处理。

→ 活动与报名

公开资料中的协会网站

2026年10月29日 · API · 新增

协会的公开资料（GET /v1/aps/{slug}）包含 aps.website：协会自己的网站（http 或 https），未提供时为 null。协会不接受申请时，入会表单会链接到该网站。

→ GET /v1/aps/{slug}

“使用 Vimine 登录”采用协会的配色

2026年10月29日 · 托管页面 · 新增

登录页面会在 Vimine 旁显示协会的名称和标志，以及会员之后返回的网站地址。每个应用都可以在“协会 › 开发者”中为该页面设置自己的颜色和字体。尚未激活的应用会在错误信息中显示其名称。

→ 使用 Vimine 登录

会话会注明协会

2026年10月29日 · SDK 0.3.6 · 新增

getSession().aps 说明会员登录的是哪个协会（slug、name、picture_url），令牌续期后仍会保留。生成的类型新增 Spec.Regolamento、Spec.operations.getApsRegolamento，以及 Spec.ApsPublicConfig 中的 aps.website。

→ Vimine（浏览器）

繁体中文采用台湾用语

2026年10月27日 · WordPress 插件 0.1.5 · 修复

插件的繁体中文翻译（zh_TW）现已采用台湾用语（登出、QR Code、重新導向…）：此前它由简体中文机器转换而来，连用词也一并照搬。

→ WordPress 插件

协会规章

2026年10月26日 · API · 新增

GET /v1/aps/{slug}/regolamento 返回协会现行的规章（章程之外的规则），提供 Markdown 和 HTML 两种格式（?locale=，否则为意大利语）。规章仅供阅读：入会申请不会记录对它的接受。

→ GET /v1/aps/{slug}/regolamento

繁体中文采用台湾用语

2026年10月25日 · SDK 0.3.5 · 修复

元素的繁体中文文本现已采用台湾用语（登出、QR Code、發生錯誤…）：此前它们由简体中文机器转换而来，连用词也一并照搬。

→ 元素（低代码）

八种语言

2026年10月20日 · API · 新增

?locale= 和 ui_locales 现在也接受 fr、es、de、pt-BR、zh-Hans 和 zh-Hant，以及地区标签（zh-TW 对应繁体中文，pt-PT 对应葡萄牙语）。SDK 的元素和 WordPress 插件会跟随页面的语言。

→ 语言

内测与沙盒

2026年10月20日 · API · 变更

协会的公开资料包含 accepting_requests 和 invitation_only：当协会只接纳受邀者时，/v1/enroll、/v1/signup 和 /v1/me/membership 返回 403 not_available。在沙盒中，/v1/signup 和 /v1/enroll 只会在沙盒自己的域名下创建测试用户，绝不会创建真实账户。

→ 沙盒与测试客户端

与您网站风格一致的入会表单

2026年10月19日 · 托管页面 · 变更

嵌入式入会表单会从其地址的参数中读取明暗模式、强调色、背景和字体（scheme、accent、background、font：可从八种字体中选择，或使用系统字体）。协会颜色已取消，/v1/aps 的响应中也不再包含 brandcolor。

→ 嵌入与会员卡核验

隐私声明、监护人、章程、嘉宾

2026年10月19日 · API · 变更

POST /v1/me/membership 要求确认已阅读隐私声明（否则返回 422），并接受地址和语言；/v1/enroll 接受未成年人的监护人信息，GET /v1/aps/{slug}/statuto 返回章程，尚未准备就绪的协会返回 403 not_available。嘉宾可以通过 POST /v1/registrations/view 查看自己的名额；对于已过期的会员卡，扫码器返回 EXPIRED，对于已关闭的协会则返回 VOID，不再报错。

→ 入会审批与生效

2026年9月

仅限会员的活动，登录时使用通行密钥

2026年9月27日 · API · 新增

报名记录会说明取消原因（cancel_reason，共七种，包括申请被拒和会员卡被撤销）；对于仅限会员的活动，API 只为持有有效会员卡的人报名；通过您的网站入会的迁入会员也会以同样方式被识别。“使用 Vimine 登录”页面支持通行密钥和第二步验证。JavaScript SDK 已在 npm 上发布，包名为 @vimine/sdk。

→ 活动与报名

多语言与没有税号的会员

2026年9月19日 · API · 新增

读取接口接受 ?locale=，并说明以何种语言作答（locale、locales）；入会申请和活动报名接受 locale 参数，用于确定邮件语言。识别一个人可以用税号，也可以用出生日期、出生地和出生国家。相关指南见开发者门户。

→ 没有意大利税号的会员