更新日誌

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 參數，用於確定郵件語言。識別一個人可以用稅號，也可以用出生日期、出生地和出生國家。相關指南見開發者入口網站。

→ 沒有義大利稅號的會員