Due to PCI compliant reasons we're going to turn off support for TLS v1.0 on all of our servers.
Please check/update you API implementations to support TLS v1.2 until 29.06.2018

REST API TicketTypes

From XING Events Developer Documentation
Jump to: navigation, search

Object type: ticketType
This object used to organize what ticket types are allowed for the event. If the host allows a TicketType, an object with the associated "type"-attribute is created. When the type is later removed (on the homepage) and no tickets were sold with this type yet, the whole object is deleted. If tickets were already sold for the type, the "active"-attribute will be set to false. With the REST-API you cannot delete a TicketType. The delete-method will set "active" to false.

Properties

TicketType objects provide the following properties.

Attributes: R - accessible in read requests W - accessible in write (update) requests C - accessible in create requests

Property
Type
Attributes Description

id
Integer
R--
The id of the TicketType.
type
String
R-C
The type of the TicketType.
Must be one of the following:
TICKETTYPE_ETICKET
TICKETTYPE_PAPER
TICKETTYPE_BADGE
TICKETTYPE_CONFIRMATION
TICKETTYPE_ONSITE
required
active
Boolean
RWC
Is this TicketType activated?


Methods

Read

Call GET /api/ticketType/<id>
Description This request will return the TicketType object with the specified internal id. The response contains all properties marked with R.
Response {"ticketType":{"id": ...}, "success":true}.
Errors See General Errorcodes.

Create

Call POST /api/event/<id>/ticketType/create
Parameters All properties marked with C. type is required.
Description This request will register a TicketType and will return the internal id. The internal id can be used for read or update requests.
Response {"id":<internal id>,"success":true}.
Errors com.amiando.api.rest.ticketType.TicketTypeNotAllowed

com.amiando.api.rest.ticketType.TicketTypeAlreadyExists
See General Errorcodes.

Update

Call POST /api/ticketType/<id>
Parameters All properties marked with W.
Description This request will update the properties of the TicketType with the internal id <id>. Only properties which are provided as parameters will be updated.
Response {"success":true}.
Errors See General Errorcodes.

Get List

Call GET /api/event/<id>/ticketTypes
Description This request will return the TicketType objects belonging to the event with the specified internal id. The response contains all properties marked with R.
Response {"results": "availableTicketTypes": ["TICKETTYPE_ETICKET", ...]" ticketTypes":[{"id": ...},...], "success":true}.
Errors See General Errorcodes.

Delete

Call DELETE /api/ticketType/<id>
Description This request will not delete but deactivate the TicketType with the specified internal id. The response is always deleted:false.
Response {"deleted":false, "success":true}.
Errors See General Errorcodes.
REST API Contents
Getting Started Get your API key Overview Formats Errors
Data Types Event Participant Payment Ticket
Ticket Categories ProductDefinition Products CodeDefinition
TicketShop Addresses Ticket Types Payment Types
BankAccount UserDataDefinition UserData User
Partner ApiKey
Data Synchronization Sync Interface