確認代您提交的入會申請（來自電子郵件中的連結）

POST

/v1/enroll/confirm

curl --request POST \
  --url https://api.vimine.network/v1/enroll/confirm \
  --header 'Content-Type: application/json' \
  --data '{ "token": "example", "identification": { "dob": "2026-04-15", "birthplace": "example", "birth_country": "example", "codicefiscale": "example", "codicefiscale_confirmed": true }, "address": { "kind": "residence", "line": "example", "postal_code": "example", "city": "example", "province": "example", "country": "IT" } }'

• Vimine API

使用確認連結所攜帶的權杖，並建立待處理的入會申請。重放冪等：第二次使用連結只會報告目前狀態。

請求本文^必填

媒體類型application/json

object

token

必填

string

identification

僅在收到 409 identification_required 之後：帳戶仍缺少的內容——稅號，或者出生日期、出生地和出生國。只補全個人資料中原本為空的欄位，絕不覆蓋已有內容

object

dob

string 格式： date

birthplace

string

<= 150 個字元

birth_country

string

>= 2 個字元 <= 2 個字元

codicefiscale

string

<= 16 個字元

codicefiscale_confirmed

boolean

address

僅在收到 409 address_required 之後：協會要求每位會員提供地址（其公開資料中為 member_address: required）。協會聲明 optional 時為可選；協會不收集地址時則忽略

object

kind

string

預設值： residence

允許的值： residence domicile

line

必填

街道和門牌號

string

<= 150 個字元

postal_code

string

可為 null <= 12 個字元

city

必填

string

<= 150 個字元

province

僅限義大利地址（兩個字母）；國外地址會捨棄此欄位

string

可為 null <= 2 個字元

country

ISO 3166-1 alpha-2

string

預設值： IT >= 2 個字元 <= 2 個字元

回應

200

在該協會的入會申請

媒體類型application/json

object

status

必填

string

允許的值： pending active suspended revoked rejected

already

必填

當事人在此已有入會申請或會員資格

boolean

pending_reasons

會員資格仍在等待的原因，按順序排列：先是協會的審核（協會由理事會決定是否接納時），然後是會費。生效後為空

Array<string>

允許的值： approval payment

payment_open

現在可以繳納會費了嗎？審核尚未完成時為 false：獲准入會後才開放繳費

boolean

valid_from

會員卡何時可以使用，用於處於協會設定間隔期內的有效會員資格；否則為 null

string 格式： date-time

可為 null

association

必填

object

name

string

slug

string

event

僅適用於協會託管的入會頁面從其某個公開活動開啟時所發出的連結：當事人隨入會申請一起申請的名額結果如何。其他任何連結均為 null

object

slug

string

title

string

starts_at

string 格式： date-time

timezone

string

place

string

可為 null

registration_type

object

uid

string 格式： uuid

name

string

amount

0 = 免費

number

currency

string

state

confirmed：名額歸當事人所有。reserved：已保留，參見 waiting。held：入會申請本身仍在等待電子郵件地址確認，且尚未申請任何名額。unavailable：沒有名額，參見 reasons

string

允許的值： confirmed reserved held unavailable

waiting

reserved 名額在等待什麼：會員資格生效（屆時若免費則自動確認）、參與費，或兩者皆是

Array<string>

允許的值： membership contribution

reasons

名額為何為 unavailable：即 GET /v1/events/{slug}/eligibility 給出的原因

Array<string>

reserved_until

string 格式： date-time

可為 null

payment_instructions

應付參與費的繳納方式，按協會的表述

string

可為 null

already

在使用連結之前，當事人就已持有此名額

boolean

範例

{
  "status": "pending",
  "pending_reasons": [
    "approval"
  ],
  "event": {
    "state": "confirmed",
    "waiting": [
      "membership"
    ]
  }
}

400

連結無效或已過期（invalid_token）

404

找不到

媒體類型application/problem+json

object

type

必填

string 格式： uri

title

必填

string

status

必填

integer

detail

string

code

必填

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

範例^自動產生

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

409

自連結發出以來章程已變更（statuto_outdated）；帳戶尚未識別身份（identification_required，errors[] 指出缺少什麼）：請帶上 identification 再次提交權杖；或者協會要求每位會員提供地址（address_required）：請帶上 address 再次提交權杖

422

identification 區塊未通過驗證（validation_failed）

429

超出速率限制

媒體類型application/problem+json

object

type

必填

string 格式： uri

title

必填

string

status

必填

integer

detail

string

code

必填

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

範例^自動產生

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

內部錯誤

媒體類型application/problem+json

object

type

必填

string 格式： uri

title

必填

string

status

必填

integer

detail

string

code

必填

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

範例^自動產生

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}