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
- 1Nell'admin di ticketick, pagina «API & agenti IA», crea una chiave. Seleziona «Può pubblicare» solo se l'agente deve mettere online da sé.
- 2Aggiungi il server MCP al tuo agente con la chiave nell'intestazione Authorization.
- 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.