确认代您提交的入会申请（来自邮件中的链接）

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"
    }
  ]
}