Simple service for lazy integration

GET /v1/services/simple/events

Returns comprehensive information about available events.

Request Headers:  

• Accept – application/json
• Authorization – API key

Query Parameters:  

• ids – Returns only events with ids
• org – Filter by org
• tags – comma separated list of tags
• lifetime__range – two comma separated datetimes
• price__range – two comma separated numbers
• created_at__since – Returns events which were created since the specified date.
• updated_at__since – Returns events which were updated since the specified date.
• country – filter by coutntry
• city – filter by city
• venue – filter by venue
• page – page number
• page_size – number events on page
• sort –

  Sort events. One of “start”, “end”, “price”, “-start”, “-end” or “-price”.

  • start sort by events start
  • end sort by events start
  • price sort by minimal price

Response Headers:  

• Content-Type – application/json
• Transfer-Encoding – chunked

Response JSON Array of Objects:  

• id (string) – Event id
• age_rating (string) –
• created_at (datetime) – Event creation timestamp
• deal (object) –

  Deal terms (only for agents)

  • org
  • agent
  • extra
  • pfc
• lifetime (string) – Event duration in iCal format
• map (object) –
• media (array) – Media files
• org (object) –

  Organizer information object

  • id (string)
  • contact (object)
  • desc (string)
  • media (object)
  • name (string)
  • tags (list of string)
• sets (array) –

  List of available sets including:

  • id (string): Set id
  • seats (map): Seats in this set
  • amount (number): Amount tickets in set
  • amount_vacant (number): Amount of available tickets in set
  • name (string): Description
  • price (string): Cost of single ticket including the terms from the current rule
  • price_extra (string): Extra price on top of base one
  • price_org (string): Base price for tickets provided by a organizer
  • rules (array of objects): List of rules applicable to this set. The current one is defined by the flag current: true
  • sector (string): sector if map exist
• status (string) – event status
• tags (array) – List of event tags
• tickets_amount (number) – amount tickets
• tickets_amount_vacant (number) – amount vacant tickets
• title (object) –

  Event name and description

  • desc (string)
  • text (string)
• updated_at (datetime) – Event last update timestamp
• venue (object) –

  Venue information object

  • id (string)
  • address (string)
  • city (object) City object
  • country (object) Country object
  • desc (string)
  • name (string)
  • point (object) GeoJSON Point

Status Codes:

• 200 OK – Ok
• 400 Bad Request – Invalid request parameters
• 403 Forbidden – Operation not allowed

Request

GET /v1/services/simple/events HTTP/1.1
Accept: application/json
Authorization: key your-very-secret-key
Host: ticketscloud.org

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Transfer-Encoding: chunked

[
    {
        "created_at": "2014-09-19T10:30:24.388000+00:00",
        "deal": {
            "org": "93.0%",
            "agent": "7.0%",
            "extra": "10.0%",
            "pfc": false
        },
        "id": "541c05c037abbd1af8b3398e",
        "lifetime": "BEGIN:VEVENT\r\nDTSTART:20141001T170000Z\r\nDTEND:20141001T190000Z\r\nEND:VEVENT\r\n",
        "media": {
            "logo": {
                "author": "535fb19bdca6a9d1638f2007",
                "content_type": "image/jpeg",
                "id": "545b686b37abbd08a96e50a5",
                "length": 72122,
                "md5hash": "0db79df4bbef2e847e31e46508f1d43e",
                "url": "https://s3-eu-west-1.amazonaws.com/media.ticketscloud/9a44bb963ae44db8a443d1f3c19ed39e.jpeg"
            }
        },
        "org": {
            "contact": {},
            "desc": null,
            "id": "5357b929f51600525c9e1396",
            "name": "Organizator",
            "tags": []
        },
        "sets": [
            {
                "amount": 100,
                "amount_vacant": 13,
                "id": "541c05c037abbd1af8b33992",
                "name": "foo",
                "price": "1105.5",
                "price_extra": "100.5",
                "price_org": "1005.00",
                "rules": [
                    {
                        "cal": "BEGIN:VEVENT\r\nDTSTART:20140901T170000Z\r\nDTEND:20141001T190000Z\r\nEND:VEVENT\r\n",
                        "current": true,
                        "id": "541c05c037abbd1af8b33990",
                        "price": "1105.5",
                        "price_extra": "100.5",
                        "price_org": "1005.00"
                    }
                ]
            }
        ],
        "tags": [
            "концерты",
            "вечеринки"
        ],
        "title": {
            "desc": "Возвращение музыканта в хорошем расположении духа и с новой программой",
            "text": "Найк Борзов"
        },
        "updated_at": "2014-09-19T10:30:24.793000+00:00",
        "venue": {
            "address": "Кутузовский просп., 25",
            "city": {},
            "country": {},
            "desc": "Представления с участием кошек и Куклачевых",
            "id": "53eca6fd0fc5f66be2610d8c",
            "name": "Театр кошек Юрия Куклачева",
            "point": {
                "coordinates": [
                    55.7444151,
                    37.5458909
                ],
                "type": "Point"
            }
        }
    },
    {
        "created_at": "2014-09-19T11:10:31.922000+00:00",
        "deal": {
            "org": "93.0%",
            "agent": "7.0%",
            "extra": "10.0%",
            "pfc": false
        },
        "id": "541c0f2737abbd1c64b61b48",
        "lifetime": "BEGIN:VEVENT\r\nDTSTART:20141001T170000Z\r\nDTEND:20141001T190000Z\r\nEND:VEVENT\r\n",
        "org": {
            "contact": {},
            "desc": null,
            "id": "5357b929f51600525c9e1396",
            "name": "Organizator",
            "tags": []
        },
        "sets": [
            {
                "amount": 100,
                "amount_vacant": 13,
                "id": "541c0f2737abbd1c64b61b4c",
                "name": "foo",
                "price": "1105.5",
                "price_extra": "100.5",
                "price_org": "1005.00",
                "rules": [
                    {
                        "cal": "BEGIN:VEVENT\r\nDTSTART:20140901T170000Z\r\nDTEND:20141001T190000Z\r\nEND:VEVENT\r\n",
                        "current": true,
                        "id": "541c0f2737abbd1c64b61b4a",
                        "price": "1105.5",
                        "price_extra": "100.5",
                        "price_org": "1005.00"
                    }
                ]
            }
        ],
        "tags": [
            "концерты",
            "вечеринки"
        ],
        "title": {
            "desc": "Возвращение музыканта в хорошем расположении духа и с новой программой",
            "text": "Найк Борзов"
        },
        "updated_at": "2014-09-19T11:10:32.235000+00:00",
        "venue": {
            "address": "Кутузовский просп., 25",
            "city": {},
            "country": {},
            "desc": "Представления с участием кошек и Куклачевых",
            "id": "53eca6fd0fc5f66be2610d8c",
            "name": "Театр кошек Юрия Куклачева",
            "point": {
                "coordinates": [
                    55.7444151,
                    37.5458909
                ],
                "type": "Point"
            }
        }
    }
]

GET /v1/services/simple/events/{idevent}

Returns comprehensive information about specific event.

Parameters:

• idevent – Event id

Request Headers:  

• Accept – application/json
• Authorization – API key

Query Parameters:  

• updated_at__gt – Returns events which were updated since the specified date. The date should be defined in ISO-8601 format.

Response Headers:  

• Content-Type – application/json
• Transfer-Encoding – chunked

Response JSON Array of Objects:  

• id (string) – Event id
• age_rating (string) –
• created_at (datetime) – Event creation timestamp
• deal (object) –

  Deal terms (only for agents)

  • org
  • agent
  • extra
  • pfc
• lifetime (string) – Event duration in iCal format
• map (object) –
• media (array) – Media files
• org (object) –

  Organizer information object

  • id (string)
  • contact (object)
  • desc (string)
  • media (object)
  • name (string)
  • tags (list of string)
• sets (array) –

  List of available sets including:

  • id (string): Set id
  • amount (number): Amount tickets in set
  • amount_vacant (number): Amount of available tickets in set
  • name (string): Description
  • price (string): Cost of single ticket including the terms from the current rule
  • price_extra (string): Extra price on top of base one
  • price_org (string): Base price for tickets provided by a organizer
  • rules (array of objects): List of rules applicable to this set. The current one is defined by the flag current: true
  • sector (string): sector if map exist
• status (string) – event status
• tags (array) – List of event tags
• tickets_amount (number) – amount tickets
• tickets_amount_vacant (number) – amount vacant tickets
• title (object) –

  Event name and description

  • desc (string)
  • text (string)
• updated_at (datetime) – Event last update timestamp
• venue (object) –

  Venue information object

  • id (string)
  • address (string)
  • city (object) City object
  • country (object) Country object
  • desc (string)
  • name (string)
  • point (object) GeoJSON Point

Status Codes:

• 200 OK – Ok
• 400 Bad Request – Invalid request parameters
• 401 Unauthorized – Authentication required
• 403 Forbidden – Operation not allowed

Request

GET /v1/services/simple/events/5357baaff51600525c9e1397 HTTP/1.1
Accept: application/json
Authorization: key your-very-secret-key
Host: ticketscloud.org

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Transfer-Encoding: chunked

{
    "created_at": "2014-09-19T11:10:31.922000+00:00",
    "deal": {
        "org": "93.0%",
        "agent": "7.0%",
        "extra": "10.0%",
        "pfc": false
    },
    "id": "541c0f2737abbd1c64b61b48",
    "lifetime": "BEGIN:VEVENT\r\nDTSTART:20141001T170000Z\r\nDTEND:20141001T190000Z\r\nEND:VEVENT\r\n",
    "org": {
        "contact": {},
        "desc": null,
        "id": "5357b929f51600525c9e1396",
        "name": "Organizator",
        "tags": []
    },
    "sets": [
        {
            "amount": 100,
            "amount_vacant": 13,
            "id": "541c0f2737abbd1c64b61b4c",
            "name": "foo",
            "price": "1105.5",
            "price_extra": "100.5",
            "price_org": "1005.00",
            "rules": [
                {
                    "cal": "BEGIN:VEVENT\r\nDTSTART:20140901T170000Z\r\nDTEND:20141001T190000Z\r\nEND:VEVENT\r\n",
                    "current": true,
                    "id": "541c0f2737abbd1c64b61b4a",
                    "price": "1105.5",
                    "price_extra": "100.5",
                    "price_org": "1005.00"
                }
            ]
        }
    ],
    "tags": [
        "концерты",
        "вечеринки"
    ],
    "title": {
        "desc": "Возвращение музыканта в хорошем расположении духа и с новой программой",
        "text": "Найк Борзов"
    },
    "updated_at": "2014-09-19T11:10:32.235000+00:00",
    "venue": {
        "address": "Кутузовский просп., 25",
        "city": {},
        "country": {},
        "desc": "Представления с участием кошек и Куклачевых",
        "id": "53eca6fd0fc5f66be2610d8c",
        "name": "Театр кошек Юрия Куклачева",
        "point": {
            "coordinates": [
                55.7444151,
                37.5458909
            ],
            "type": "Point"
        }
    }
}