Aller au contenu
Vimine pour les développeurs
FR

Les événements publiés de l’association, y compris ceux réservés aux membres

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

Autorisations

Section intitulée « Autorisations »

Paramètres

Section intitulée « Paramètres »

Paramètres de requête

Section intitulée « Paramètres de requête »
locale

La langue dans laquelle lire le contenu de l’association (it, en). Par défaut : la langue du membre lui-même (jeton de membre), puis Accept-Language, puis celle de l’association. Chaque texte est la traduction de l’association quand elle en a écrit une pour une langue qu’elle a activée, son texte italien sinon : le locale de la réponse dit laquelle a été servie pour le titre, locales lesquelles existent. Une valeur non prise en charge est ignorée

string
filter
string
Valeurs autorisées : upcoming past cancelled all
from
string format : date-time
to
string format : date-time
limit
integer
>= 1 <= 200

Réponses

Section intitulée « Réponses »

200

Section intitulée « 200 »

Événements

Type de médiaapplication/json
object
items
Array<object>
object
id
string format : uuid
slug
string
locale

La langue dans laquelle le title a été servi. Quand ce n’est pas celle que vous avez demandée, l’association n’a pas de traduction : vous avez reçu son texte italien, pas une traduction automatique

string
locales

Les langues dans lesquelles cet événement a un titre — toujours celle de l’association, plus celles qu’elle a activées et dans lesquelles elle l’a écrit

Array<string>
title
string
summary
string
nullable
description_md

Markdown ; faites-en le rendu vous-même

string
nullable
starts_at
string format : date-time
ends_at
string format : date-time
nullable
timezone
string
status
string
Valeurs autorisées : published completed cancelled
visibility
string
Valeurs autorisées : 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 format : date-time
nullable
closes_at
string format : date-time
nullable
capacity
integer
nullable
remaining
integer
nullable
cancellation_hours
integer
registration_types
Array<object>
object
uid
string format : uuid
cod
string
name
string
description
string
nullable
amount

0 = gratuit

number
currency
string
quantity
integer
nullable
remaining

Places restantes (jamais qui les occupe)

integer
nullable
max_per_user
integer
requires_active_membership
boolean
open
boolean
reason
string
nullable
Valeurs autorisées : sold_out registration_not_open registration_closed
opens_at
string format : date-time
nullable
closes_at
string format : date-time
nullable
published_at
string format : date-time
nullable
cancelled_at
string format : date-time
nullable
cancel_reason
string
nullable
Exemple
{
  "items": [
    {
      "status": "published",
      "visibility": "members_only",
      "registration_types": [
        {
          "reason": "sold_out"
        }
      ]
    }
  ]
}

400

Section intitulée « 400 »

Requête invalide

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

401

Section intitulée « 401 »

Identifiants manquants ou invalides

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Section intitulée « 403 »

Non autorisé

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Section intitulée « 404 »

Introuvable

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

429

Section intitulée « 429 »

Limite de débit atteinte

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Section intitulée « 500 »

Erreur interne

Type de médiaapplication/problem+json
object
type
obligatoire
string format : uri
title
obligatoire
string
status
obligatoire
integer
detail
string
code
obligatoire
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Exemplegénéré
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}