Zum Inhalt springen
Vimine für Entwickler
DE

Eine veröffentlichte Veranstaltung des Vereins, mit Live-Verfügbarkeit

GET
/v1/events/{slug}
curl --request GET \
  --url https://api.vimine.network/v1/events/example \
  --header 'Authorization: Bearer <token>'

Autorisierungen

Abschnitt betitelt „Autorisierungen“

Parameter

Abschnitt betitelt „Parameter“

Pfadparameter

Abschnitt betitelt „Pfadparameter“
slug
erforderlich
string

Query-Parameter

Abschnitt betitelt „Query-Parameter“
locale

Die Sprache, in der die Texte des Vereins gelesen werden (it, en). Standard: die eigene Sprache des Mitglieds (Mitglieder-Token), dann Accept-Language, dann die des Vereins. Jeder Text ist die Übersetzung des Vereins, wenn er eine für eine von ihm aktivierte Sprache geschrieben hat, sonst sein italienischer Text: locale in der Antwort sagt, welche für den Titel geliefert wurde, locales, welche es gibt. Ein nicht unterstützter Wert wird ignoriert

string

Antworten

Abschnitt betitelt „Antworten“

200

Abschnitt betitelt „200“

Veranstaltung

Medientypapplication/json
object
id
string Format: uuid
slug
string
locale

Die Sprache, in der title geliefert wurde. Ist sie nicht die angeforderte, hat der Verein keine Übersetzung: Sie haben seinen italienischen Text erhalten, keine maschinelle Übersetzung

string
locales

Die Sprachen, in denen diese Veranstaltung einen Titel hat — immer die eigene des Vereins, dazu die, die er aktiviert und geschrieben hat

Array<string>
title
string
summary
string
nullable
description_md

Markdown; rendern Sie es selbst

string
nullable
starts_at
string Format: date-time
ends_at
string Format: date-time
nullable
timezone
string
status
string
Erlaubte Werte: published completed cancelled
visibility
string
Erlaubte Werte: 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 = kostenlos

number
currency
string
quantity
integer
nullable
remaining

Verbleibende Plätze (nie, wer die Plätze belegt)

integer
nullable
max_per_user
integer
requires_active_membership
boolean
open
boolean
reason
string
nullable
Erlaubte Werte: 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
Beispiel
{
  "status": "published",
  "visibility": "members_only",
  "registration_types": [
    {
      "reason": "sold_out"
    }
  ]
}

400

Abschnitt betitelt „400“

Ungültige Anfrage

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

401

Abschnitt betitelt „401“

Fehlende oder ungültige Zugangsdaten

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Abschnitt betitelt „403“

Nicht erlaubt

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Abschnitt betitelt „404“

Nicht gefunden

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

429

Abschnitt betitelt „429“

Ratenlimit überschritten

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Abschnitt betitelt „500“

Interner Fehler

Medientypapplication/problem+json
object
type
erforderlich
string Format: uri
title
erforderlich
string
status
erforderlich
integer
detail
string
code
erforderlich
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Beispielerzeugt
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}