Renovar la inscripción (por cuenta propia)

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

Dentro de la ventana de renovación (60 días antes de la caducidad, o después de ella). Un tipo de carné gratuito que no requiere aprobación se renueva de inmediato (renewed: true, nuevo expires_at); si no, se registra una solicitud de renovación y se avisa a la asociación (requested: true) — se completa cuando la secretaría registra la cuota o la aprueba. accept_statuto debe nombrar el estatuto en vigor. Repetir la solicitud no tiene ningún efecto.

Autorizaciones

• BearerToken
  membership:request

Cuerpo de la petición^obligatorio

Tipo de medioapplication/json

object

accept_statuto

obligatorio

object

version

obligatorio

integer

sha256

string

Ejemplo^generado

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

Respuestas

200

Renovada o solicitada

Tipo de medioapplication/json

object

renewed

boolean

requested

boolean

status

string

expires_at

string formato: date-time

nullable

renewal_requested_at

string formato: date-time

nullable

Ejemplo^generado

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

400

Petición no válida

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

401

Credenciales ausentes o no válidas

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

403

No permitido

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

404

No encontrado

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

409

Fuera de la ventana de renovación (too_early) o la inscripción no se puede renovar (not_renewable)

422

accept_statuto no nombra el estatuto en vigor

429

Límite de frecuencia superado

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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

500

Error interno

Tipo de medioapplication/problem+json

object

type

obligatorio

string formato: uri

title

obligatorio

string

status

obligatorio

integer

detail

string

code

obligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Ejemplo^generado

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