Typy událostí

Tato stránka obsahuje kompletní seznam všech typů událostí, které můžete přijímat přes webhooky.

Získání seznamu typů

Aktuální seznam podporovaných typů událostí můžete získat přes API:

curl -X GET "https://api.klubero.cz/api/v1.0/webhooks/event-types" \
  -H "Authorization: Bearer {access_token}"

Odpověď:

{
  "success": true,
  "data": [
    "user.created",
    "user.updated",
    "user.deleted",
    "ticket.created",
    "ticket.updated",
    "ticket.deleted",
    "permanent_ticket.created",
    "permanent_ticket.updated",
    "permanent_ticket.deleted",
    "ticket_transfer.created",
    "ticket_transfer.accepted",
    "ticket_transfer.declined",
    "ticket_transfer.cancelled",
    "ticket_return.created",
    "permanent_ticket_return.created"
  ]
}

---

Přehled typů událostí

Typ události	Kategorie	Popis
user.created	Uživatelé	Nový uživatel byl vytvořen
user.updated	Uživatelé	Profil uživatele byl aktualizován
user.deleted	Uživatelé	Uživatel byl smazán
ticket.created	Vstupenky	Nová vstupenka byla vytvořena
ticket.updated	Vstupenky	Vstupenka byla aktualizována
ticket.deleted	Vstupenky	Vstupenka byla smazána
permanent_ticket.created	Permanentky	Nová permanentka byla vytvořena
permanent_ticket.updated	Permanentky	Permanentka byla aktualizována
permanent_ticket.deleted	Permanentky	Permanentka byla smazána
ticket_transfer.created	Převody vstupenek	Převod vstupenky byl zahájen
ticket_transfer.accepted	Převody vstupenek	Převod vstupenky byl přijat
ticket_transfer.declined	Převody vstupenek	Převod vstupenky byl odmítnut
ticket_transfer.cancelled	Převody vstupenek	Převod vstupenky byl zrušen odesílatelem
ticket_return.created	Vrácení vstupenek	Vstupenka byla vrácena
permanent_ticket_return.created	Vrácení permanentek	Permanentka byla vrácena

---

Události uživatelů

user.created

Odesláno když je v systému vytvořen nový uživatel.

Kdy se odesílá:

• Registrace nového uživatele
• Vytvoření uživatele administrátorem

Příklad payloadu:

{
  "event": "user.created",
  "entity_id": 12345,
  "occurred_at": "2024-01-15T10:30:00Z",
  "data": {
    "user_id": 12345,
    "email": "jan.novak@example.com",
    "firstname": "Jan",
    "surname": "Novák",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

user.updated

Odesláno když je profil uživatele aktualizován.

Kdy se odesílá:

• Uživatel aktualizuje svůj profil
• Administrátor upraví uživatele
• Změna nastavení účtu

Příklad payloadu:

{
  "event": "user.updated",
  "entity_id": 12345,
  "occurred_at": "2024-01-15T14:22:00Z",
  "data": {
    "user_id": 12345,
    "email": "jan.novak@example.com",
    "firstname": "Jan",
    "surname": "Novák",
    "phone_number": "+420123456789",
    "updated_at": "2024-01-15T14:22:00Z"
  }
}

user.deleted

Odesláno když je uživatel smazán ze systému.

Kdy se odesílá:

• Smazání uživatele administrátorem
• Žádost uživatele o smazání účtu (GDPR)

Příklad payloadu:

{
  "event": "user.deleted",
  "entity_id": 12345,
  "occurred_at": "2024-01-15T16:45:00Z",
  "data": {
    "user_id": 12345
  }
}

note

Při smazání uživatele je payload minimální z důvodu ochrany osobních údajů.

---

Události vstupenek

ticket.created

Odesláno když je vytvořena nová vstupenka.

Kdy se odesílá:

• Nákup vstupenky
• Vytvoření vstupenky administrátorem

Příklad payloadu:

{
  "event": "ticket.created",
  "entity_id": 98765,
  "occurred_at": "2024-01-15T11:00:00Z",
  "data": {
    "ticket_id": 98765,
    "event_id": 100,
    "event_title": "Ligový zápas - Domácí vs Hosté",
    "user_id": 12345,
    "sector_id": 5,
    "sector_name": "Tribuna A",
    "row_id": 10,
    "row_name": "Řada 10",
    "seat_id": 25,
    "seat_name": "Sedadlo 25",
    "price": 350.00,
    "currency": "CZK",
    "created_at": "2024-01-15T11:00:00Z"
  }
}

ticket.updated

Odesláno když je vstupenka aktualizována.

Kdy se odesílá:

• Změna vlastníka vstupenky (darování)
• Skrytí/zobrazení vstupenky
• Aktualizace detailů vstupenky

Příklad payloadu:

{
  "event": "ticket.updated",
  "entity_id": 98765,
  "occurred_at": "2024-01-15T12:30:00Z",
  "data": {
    "ticket_id": 98765,
    "event_id": 100,
    "user_id": 12345,
    "hidden": false,
    "updated_at": "2024-01-15T12:30:00Z"
  }
}

ticket.deleted

Odesláno když je vstupenka smazána.

Kdy se odesílá:

• Storno vstupenky
• Vrácení vstupenky
• Smazání administrátorem

Příklad payloadu:

{
  "event": "ticket.deleted",
  "entity_id": 98765,
  "occurred_at": "2024-01-15T13:00:00Z",
  "data": {
    "ticket_id": 98765,
    "event_id": 100,
    "user_id": 12345
  }
}

---

Události permanentních vstupenek

permanent_ticket.created

Odesláno když je vytvořena nová permanentní vstupenka.

Kdy se odesílá:

• Nákup permanentky
• Vytvoření permanentky administrátorem

Příklad payloadu:

{
  "event": "permanent_ticket.created",
  "entity_id": 55555,
  "occurred_at": "2024-01-15T09:00:00Z",
  "data": {
    "permanent_ticket_id": 55555,
    "event_category_id": 10,
    "event_category_name": "Ligová sezóna 2024/25",
    "user_id": 12345,
    "sector_id": 5,
    "sector_name": "Tribuna A",
    "row_id": 10,
    "row_name": "Řada 10",
    "seat_id": 25,
    "seat_name": "Sedadlo 25",
    "price": 5000.00,
    "currency": "CZK",
    "valid_from": "2024-07-01T00:00:00Z",
    "valid_to": "2025-06-30T23:59:59Z",
    "created_at": "2024-01-15T09:00:00Z"
  }
}

permanent_ticket.updated

Odesláno když je permanentka aktualizována.

Kdy se odesílá:

• Změna vlastníka permanentky
• Aktualizace detailů
• Prodloužení platnosti

Příklad payloadu:

{
  "event": "permanent_ticket.updated",
  "entity_id": 55555,
  "occurred_at": "2024-01-15T10:00:00Z",
  "data": {
    "permanent_ticket_id": 55555,
    "event_category_id": 10,
    "user_id": 12345,
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

permanent_ticket.deleted

Odesláno když je permanentka smazána.

Kdy se odesílá:

• Zrušení permanentky
• Smazání administrátorem

Příklad payloadu:

{
  "event": "permanent_ticket.deleted",
  "entity_id": 55555,
  "occurred_at": "2024-01-15T11:00:00Z",
  "data": {
    "permanent_ticket_id": 55555,
    "event_category_id": 10,
    "user_id": 12345
  }
}

---

Události převodů vstupenek

ticket_transfer.created

Odesláno když uživatel zahájí převod vstupenky na jinou osobu.

Kdy se odesílá:

• Uživatel daruje vstupenku jinému uživateli

Příklad payloadu:

{
  "event": "ticket_transfer.created",
  "entity_id": 789,
  "occurred_at": "2024-01-15T14:00:00Z",
  "data": {
    "transfer_id": 789,
    "guid": "550e8400-e29b-41d4-a716-446655440000",
    "ticket_id": 98765,
    "sender_user_id": 12345,
    "recipient_email": "prijemce@example.com",
    "status": "pending"
  }
}

ticket_transfer.accepted

Odesláno když příjemce přijme nabídnutou vstupenku.

Kdy se odesílá:

• Příjemce potvrdí přijetí vstupenky

Příklad payloadu:

{
  "event": "ticket_transfer.accepted",
  "entity_id": 789,
  "occurred_at": "2024-01-15T15:00:00Z",
  "data": {
    "transfer_id": 789,
    "guid": "550e8400-e29b-41d4-a716-446655440000",
    "ticket_id": 98765,
    "sender_user_id": 12345,
    "recipient_user_id": 67890,
    "status": "accepted"
  }
}

ticket_transfer.declined

Odesláno když příjemce odmítne nabídnutou vstupenku.

Kdy se odesílá:

• Příjemce odmítne převod

Příklad payloadu:

{
  "event": "ticket_transfer.declined",
  "entity_id": 789,
  "occurred_at": "2024-01-15T15:00:00Z",
  "data": {
    "transfer_id": 789,
    "guid": "550e8400-e29b-41d4-a716-446655440000",
    "ticket_id": 98765,
    "sender_user_id": 12345,
    "recipient_email": "prijemce@example.com",
    "status": "declined"
  }
}

ticket_transfer.cancelled

Odesláno když odesílatel zruší převod před jeho přijetím.

Kdy se odesílá:

• Odesílatel zruší čekající převod

Příklad payloadu:

{
  "event": "ticket_transfer.cancelled",
  "entity_id": 789,
  "occurred_at": "2024-01-15T14:30:00Z",
  "data": {
    "transfer_id": 789,
    "guid": "550e8400-e29b-41d4-a716-446655440000",
    "ticket_id": 98765,
    "sender_user_id": 12345,
    "recipient_email": "prijemce@example.com",
    "status": "cancelled"
  }
}

---

Události vrácení vstupenek

ticket_return.created

Odesláno když uživatel vrátí vstupenku.

Kdy se odesílá:

• Uživatel požádá o vrácení vstupenky
• Částka je připsána do peněženky uživatele

Příklad payloadu:

{
  "event": "ticket_return.created",
  "entity_id": 98765,
  "occurred_at": "2024-01-15T16:00:00Z",
  "data": {
    "ticket_id": 98765,
    "user_id": 12345,
    "event_id": 100,
    "order_id": 5000,
    "refund_amount": 350.00,
    "wallet_balance": 850.00,
    "reason": "Nemohu se zúčastnit"
  }
}

permanent_ticket_return.created

Odesláno když uživatel vrátí permanentku.

Kdy se odesílá:

• Uživatel požádá o vrácení permanentky
• Částka je připsána do peněženky uživatele

Příklad payloadu:

{
  "event": "permanent_ticket_return.created",
  "entity_id": 55555,
  "occurred_at": "2024-01-15T16:00:00Z",
  "data": {
    "permanent_ticket_id": 55555,
    "user_id": 12345,
    "event_category_id": 10,
    "order_id": 4500,
    "refund_amount": 5000.00,
    "wallet_balance": 5850.00,
    "reason": "Stěhuji se"
  }
}

---

Filtrování událostí

Při registraci webhooku specifikujete, které typy událostí chcete přijímat v poli event_types:

{
  "url": "https://example.com/webhooks",
  "event_types": ["user.created", "ticket.created", "ticket_transfer.accepted"]
}

tip

Doporučujeme registrovat webhook pouze pro události, které skutečně potřebujete zpracovávat. Snížíte tak zatížení vašeho serveru.

Více informací o registraci webhooků najdete v sekci Konfigurace webhooků.