Los eventos publicados de la asociación, incluidos los que son solo para socios

GET

/v1/events

curl --request GET \
  --url 'https://api.vimine.network/v1/events?filter=upcoming' \
  --header 'Authorization: Bearer <token>'

• Vimine API

Autorizaciones

• BearerToken
  events:read

Parámetros

Parámetros de consulta

locale

El idioma en el que leer los textos de la asociación (it, en). Por defecto: el idioma del propio socio (token de socio), después Accept-Language y, por último, el de la asociación. Cada texto es la traducción de la asociación cuando ha escrito una para un idioma que ha activado; si no, su texto italiano: locale en la respuesta dice cuál se ha servido para el título; locales, cuáles existen. Un valor no admitido se ignora

string

filter

string

Valores permitidos: upcoming past cancelled all

from

string formato: date-time

to

string formato: date-time

limit

integer

>= 1 <= 200

Respuestas

200

Eventos

Tipo de medioapplication/json

object

items

Array<object>

object

id

string formato: uuid

slug

string

locale

El idioma en el que se ha servido el title. Cuando no es el que pediste, la asociación no tiene traducción: has recibido su texto italiano, no una traducción automática

string

locales

Los idiomas en los que este evento tiene título — siempre el de la asociación, más los que ha activado y en los que ha escrito

Array<string>

title

string

summary

string

nullable

description_md

Markdown; renderízalo tú

string

nullable

starts_at

string formato: date-time

ends_at

string formato: date-time

nullable

timezone

string

status

string

Valores permitidos: published completed cancelled

visibility

string

Valores permitidos: members_only public

location

object

name

string

nullable

address

string

nullable

lat

number

nullable

lng

number

nullable

cover_url

string

nullable

gallery

Array<object>

object

url

string

alt

string

nullable

order

integer

links

Array<object>

object

label

string

url

string

registration

object

opens_at

string formato: date-time

nullable

closes_at

string formato: date-time

nullable

capacity

integer

nullable

remaining

integer

nullable

cancellation_hours

integer

registration_types

Array<object>

object

uid

string formato: uuid

cod

string

name

string

description

string

nullable

amount

0 = gratuito

number

currency

string

quantity

integer

nullable

remaining

Plazas que quedan (nunca quién las ocupa)

integer

nullable

max_per_user

integer

requires_active_membership

boolean

open

boolean

reason

string

nullable

Valores permitidos: sold_out registration_not_open registration_closed

opens_at

string formato: date-time

nullable

closes_at

string formato: date-time

nullable

published_at

string formato: date-time

nullable

cancelled_at

string formato: date-time

nullable

cancel_reason

string

nullable

Ejemplo

{
  "items": [
    {
      "status": "published",
      "visibility": "members_only",
      "registration_types": [
        {
          "reason": "sold_out"
        }
      ]
    }
  ]
}

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

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