SpettacoliCome funzionaSono un organizzatore

API e agenti IA

Lascia che il tuo agente IA crei spettacoli, rappresentazioni e tariffe su ticketick, oppure interroga il nostro catalogo di concerti e festival in Svizzera.

Server MCP

Collega Claude, ChatGPT, Cursor o qualsiasi agente compatibile MCP: crea e pubblica i tuoi eventi in linguaggio naturale.

API REST

JSON, una chiave per organizzatore, specifica OpenAPI 3.1. Le stesse operazioni del server MCP.

Catalogo pubblico

Ricerca degli spettacoli in vendita, senza chiave: date, luoghi, prezzi, disponibilità e link di prenotazione.

Inizia in tre passi

  1. 1Nell'admin di ticketick, pagina «API & agenti IA», crea una chiave. Seleziona «Può pubblicare» solo se l'agente deve mettere online da sé.
  2. 2Aggiungi il server MCP al tuo agente con la chiave nell'intestazione Authorization.
  3. 3Chiedigli per esempio: «Crea il concerto di Natale il 5 dicembre alle 20 al Temple di Rougemont, 300 posti, CHF 45 intero e CHF 20 studenti.»

MCP

https://ticketick.ch/api/mcp
claude mcp add --transport http ticketick https://ticketick.ch/api/mcp \
  --header "Authorization: Bearer tt_…"
{
  "mcpServers": {
    "ticketick": {
      "type": "http",
      "url": "https://ticketick.ch/api/mcp",
      "headers": {
        "Authorization": "Bearer tt_…"
      }
    }
  }
}

Le regole

  • Un evento creato da un agente è una bozza da rileggere prima di pubblicare, a meno che la chiave possa pubblicare.
  • Una chiave agisce solo per il suo organizzatore. Puoi revocarla in qualsiasi momento.
  • Nulla che abbia venduto biglietti può essere eliminato tramite l'API, e una rappresentazione con vendite mantiene data e luogo.
  • Ora svizzera, prezzi in franchi svizzeri, testi in francese, inglese, tedesco e italiano.

Strumenti disponibili

whoamiGET /api/v1/me

Organizer account and permissions of the API key. Call it first: it states the rules (drafts, publish permission, time zone, currency).

list_eventsGET /api/v1/events

Events of the organizer (drafts included), newest first, with status, next session and tickets sold.

get_eventGET /api/v1/events/{eventId}

Full event: texts, payment, sessions, venues, ticket types, sales counters and links (public page, admin).

create_eventPOST /api/v1/events

Create an event with, in the same call, its sessions (dates, venue, capacity) and ticket types (prices in CHF). It is a draft unless publish is true and the key may publish. Times without offset are Swiss local time. Texts are per language ({ fr, en, de, it }); give at least one. Returns the event with its admin link for review.

update_eventPATCH /api/v1/events/{eventId}

Change texts, categories, visibility, payment methods, contact or cover image. Only the given fields change. A key without publish permission may only change drafts.

delete_eventDELETE /api/v1/events/{eventId}

Delete a draft event without sales, with its sessions and ticket types.

publish_eventPOST /api/v1/events/{eventId}/publish

Put the event online (status PUBLISHED). Needs a key with publish permission, an upcoming session and, for online sale, a ticket type.

unpublish_eventPOST /api/v1/events/{eventId}/unpublish

Turn an event without sales back into a draft. Needs a key with publish permission.

add_sessionPOST /api/v1/events/{eventId}/sessions

Add a dated session (performance) to an event, with its venue, capacity and ticket types.

update_sessionPATCH /api/v1/sessions/{sessionId}

Change a session's times, label, venue or capacity. A session with sold tickets keeps its date and venue (use « Programme modifié » in the admin). null clears an optional field.

delete_sessionDELETE /api/v1/sessions/{sessionId}

Delete a session without sales.

add_ticket_typePOST /api/v1/sessions/{sessionId}/ticket-types

Add a ticket type (price in CHF, quantity) to a session.

update_ticket_typePATCH /api/v1/ticket-types/{ticketTypeId}

Change a ticket type's name, price, quantity (not below sold), limit per order or sales window.

delete_ticket_typeDELETE /api/v1/ticket-types/{ticketTypeId}

Delete a ticket type without sales.

list_venuesGET /api/v1/venues

Venues already used by the organizer, or search all ticketick venues by name or city with q. Reuse a venueId rather than creating a duplicate venue.

list_categoriesGET /api/v1/categories

Event categories (slug and names) to use in create_event.

search_eventsGET /api/v1/public/eventssenza chiave

Public catalogue of ticketick.ch: upcoming concerts, festivals, theatre and shows in Switzerland, with dates, venues, prices, availability and booking links. No API key needed.

get_public_eventGET /api/v1/public/events/{slug}senza chiave

Public details of an event on ticketick.ch: full description, upcoming sessions, ticket prices, availability and booking link. No API key needed.

Per sviluppatori e modelli linguistici

ticketick

Siete voi a scegliere cosa condividiamo con terzi. Carrello e pagamento funzionano in ogni caso. Per saperne di più