Folgen

Wie kann ich die XML-API nutzen?

Die XML-API ermöglicht Ihnen z.B. die Abfrage aller Veranstaltungen des Accounts, sowie die Auswertung von Details. Ebenso ist über diese API eine Integration von Veranstaltungen bzw. der Daten in andere Anwendungen möglich.

Bitte beachten Sie, dass die Feld-Reihenfolge nicht fest ist und sich jederzeit ändern kann. Ebenso können neue Felder hinzukommen.

Zur Nutzung/Freischaltung aktivieren Sie bitte in den Benutzereinstellungen die API durch die Erzeugung eines neuen API Keys.

 

Grundlegende Funktionsweise

Grundsätzlich ist das System so aufgebaut, dass es einen API Token + API Key je Mandant gibt.

Sie finden den API Keys in Ihren Benutzereinstellungen.

 

Alle Events abrufen / Veranstaltungsliste

Abruf der Liste der Veranstaltungen eines Mandanten:

https://www.eventmanager-online.com/de/event/list/<API_USER>.xml?token=<API_TOKEN>

Der Verweis zwischen dem der Event-Liste im und der jeweiligen Veranstaltung erfolgt jeweils über das Feld "public_url" aus dem XML

 

Filtern der Veranstaltungsliste

Parameter:

/status:<Templates|all|active|default> (Zeigt nur die Templates|alles inkl. Templates|nur aktive| nur aktive + Planung)

/eventname:<VALUE>

/keyword:<VALUE>

/town:<VALUE>

/cust_1:<VALUE>

/fromTemplate: <TEMPLATE_TOKEN> // Verweis auf eine Vorlage (Feld template_token)

Die Filter sind jeweils nach folgendem Schema in den URL Aufruf zu integrieren:

https://www.eventmanager-online.com/de/event/list/<API_USER>/<FILTER>:<VALUE>.xml?token=API_TOKEN

Abruf einer einzelnen Veranstaltung und der Event-Details

https://www.eventmanager-online.com/de/event/<PUBLIC_URL>.xml?token=<API_TOKEN>

Der Abruf von Bildern etc. muss über die im XML API->SYSTEM definierten ASSET/userContent Urls erfolgen.

 

Auflösungen der Bilder (Standard):

'big' => (640, 480, 'resize')
'med' => (263, 263, 'resize')
'small' => (90, 90, 'resize')
'wizard' => (null, 60, 'resize')
'eventpage_basic' => (null, 160, 'resize')
'271x192' => (271, 192, 'resize')
'1133x800' => (1133, 800, 'resize')
'1600x300' => (1600, 300, 'resize')
'620x0' => (620, null, 'resize')
'700x0' => (700, null, 'resize')
'448300' => (448, 300, 'resize')
'medcrop' => (263, 263, 'resizeCrop')
'smallcrop' => (90, 90, 'resizeCrop')
'271x192crop' => (271, 192, 'resizeCrop')
'1133x800crop' => (1133, 800, 'resizeCrop')
'1600x300crop' => (1600, 300, 'resizeCrop')
'1188x1188crop' => array( 1188, 1188, 'resizeCrop')

"Ordner" unterhalb der Asset/userContent URLs:

"event", "location" 

Aufbau: 

ASSET/userContentURL + Ordner + size + img_url

 

Teilnehmer zur einer Veranstaltung abrufen

Der Verweis zwischen der Event-Liste bzw. dem Event und der jeweiligen Teilnehmerliste erfolgt jeweils über das Feld "public_url" aus dem XML

https://www.eventmanager-online.com/de/event/list_subscribers/<PUBLIC_URL>.xml?token=<API_TOKEN>

Abruf aller Teilnehmer über alle Veranstaltungen (Corporate Version, sofern eingerichtet)

Die Parameter page und days (bezieht sich auf das last modified) können Sie entsprechend Ihrer Anforderungen im Request anpassen. Weitere Parameter können wir bei Bedarf gerne zusätzlich einrichten.... Die Anzahl der Pages & Results können Sie im Api Header einsehen.

https://www.eventmanager-online.com/de/event/list_subscribers/companyALL/page:1/days:90.xml?token=<API_TOKEN>

Link zur Anmeldemaske

Um vom XML bzw. vom System aus auf die Anmeldemaske zu verlinken muss die Public_URL aus dem XML verwendet werden.
Die URL muss dann in dieses Format gebracht werden:

https://www.eventmanager-online.com/de/event/<PUBLIC_URL>/if

Soweit zur Basis. Die Einbindung des Formulars selbst in die Homepage kann natürlich auch mittels des JavaScripts von uns erfolgen, auch hierbei muss die Public URL entsprechend eingesetzt werden:

 

<script type="text/javascript" src="https://www.eventmanager-online.com/de/embed/<PUBLIC_URL>/height:1450/width:965.js"></script><noscript><p><a href="https://www.eventmanager-online.com/de/event/<PUBLIC_URL>/if">Jetzt online anmelden</a></p></noscript>

 

Event Types Werte

Die Event-Art kann über die type_id ermittelt werden.

id name
1 Festival
2 Konzert
3 Firmenveranstaltung
4 Party
5 Seminar / Fortbildung
6 Privat
7 Vereinsveranstaltung
11 Vorlesung
12 Geburtstag
14 Schauspiel
19 Ball
20 Benefizveranstaltung
22 Hochzeit
23 Sonstige
24 Plenum
39 Messe
58 Konferenz
74 Aktion
75 Ausstellung
76 Touren & Kurse
77 Vortrag
78 Workshop
88 Symposium
97 E-Learning
98 Webinar
99 Kongress
100 Telefonkonferenz
101 Online
102 Präsenz
103 Präsenz + Online
104 Lehrgang

 

 

Bei Fragen zur weiteren Nutzung wenden Sie sich bitte an unserem Support

0 Kommentare

Zu diesem Beitrag können keine Kommentare hinterlassen werden.