登記用戶端

每個整合都是一個用戶端，在 Vimine 應用的開發者頁面中登記。該頁面僅供協會理事會使用：如果您不是理事會成員，請找一位理事會成員為您登記用戶端，並把登入憑證交給您。

沒有協會——代理機構、外掛開發者、想試用 API 的人——可以向平台申請開發者邀請：您將擁有一個屬於自己的沙箱，即一個有虛構會員的測試協會，並在其中自行登記測試用戶端，同時接受開發者條款。正式環境用戶端仍歸您為之工作的協會所有。

用戶端類型

類型	用於	憑證	說明
網站（公開）	瀏覽器中的頁面	僅 `client_id`	必須使用 PKCE；`https` 重新導向 URI 須完全一致
原生應用	行動或桌面應用	僅 `client_id`	同上；使用回送位址重新導向（`http://127.0.0.1:{port}/…`）或自訂協定
伺服器（機密）	協會的後端系統	`client_id` + `client_secret`	secret 只顯示一次；絕不能出現在瀏覽器中

公開用戶端和原生用戶端實作使用 Vimine 登入，並以會員的權杖呼叫 API。機密用戶端還可以自行驗證（client_credentials），以使用“用戶端”權限，例如讀取會員卡狀態。

環境	位於何處	何時生效
測試	在協會的沙箱中（按需建立）	立即
生產	在真實協會中	由 Vimine 開通之後：您會收到一封電子郵件

測試用戶端簽發的權杖帶有 mode: "test"，無法觸及真實協會。它們的機密憑證以 vms_test_ 開頭。

名稱——會員將在授權同意頁面上看到的名稱（“名稱想要存取您的個人資料……”）。
類型和環境。
重新導向 URI——登入後 Vimine 可以把瀏覽器送回的頁面。比對是完全一致的（協定、主機、埠、路徑）：請登記您將使用的每一個回呼頁面。
允許的來源——您的頁面在瀏覽器中呼叫 API 時所在的來源（https://www.example.org）。它們用於 CORS，也是登出後允許重新導向的目標（post_logout_redirect_uri）。
權限——該整合可以申請的 scope。只申請您需要的：會員會看到全部權限。公開用戶端或原生用戶端只能擁有會員權限；“用戶端”權限需要機密用戶端。清單見權限、錯誤與限制。

建立時您會獲得 client_id（vmc_…），機密用戶端還會獲得 client_secret（vms_…），它只顯示一次。對於測試用戶端，頁面還會顯示沙箱中的虛構會員及其密碼。