續期會員資格（自助）

POST

/v1/me/membership/renew

curl --request POST \
  --url https://api.vimine.network/v1/me/membership/renew \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "accept_statuto": { "version": 1, "sha256": "example" } }'

• Vimine API

在續期時段內（到期前 60 天起，或到期之後）。免費且無需審核的會員卡類型會立即續期（renewed: true，新的 expires_at）；否則會記錄一份續期申請並通知協會（requested: true）——秘書處記錄會費或予以批准後即完成。accept_statuto 必須指明現行章程。重複提交此請求不會產生任何作用。

授權方式

• BearerToken
  membership:request

請求本文^必填

媒體類型application/json

object

accept_statuto

必填

object

version

必填

integer

sha256

string

範例^自動產生

{
  "accept_statuto": {
    "version": 1,
    "sha256": "example"
  }
}

回應

200

已續期或已提交申請

媒體類型application/json

object

renewed

boolean

requested

boolean

status

string

expires_at

string 格式： date-time

可為 null

renewal_requested_at

string 格式： date-time

可為 null

範例^自動產生

{
  "renewed": true,
  "requested": true,
  "status": "example",
  "expires_at": "2026-04-15T12:00:00Z",
  "renewal_requested_at": "2026-04-15T12:00:00Z"
}

400

請求無效

媒體類型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"
    }
  ]
}

401

缺少憑證或憑證無效

媒體類型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"
    }
  ]
}

403

不允許此操作

媒體類型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"
    }
  ]
}

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

不在續期時段內（too_early），或該會員資格無法續期（not_renewable）

422

accept_statuto 指明的不是現行章程

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