Los eventos públicos de una asociación

GET

/v1/aps/{slug}/events

curl --request GET \
  --url 'https://api.vimine.network/v1/aps/example/events?filter=upcoming'

• Vimine API

Eventos publicados con visibility: public, primero los más próximos (filter=upcoming por defecto; past, cancelled, all). Los eventos solo para socios no aparecen aquí: léelos con un token de socio en GET /v1/events.

Parámetros

Parámetros de ruta

slug

obligatorio

Slug público de la asociación

string

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

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