API pro vaše CRM

Propojte své CRM nebo reportingové nástroje s TixFlow a čtěte své akce, objednávky, návštěvníky a zákazníky.

Co API nabízí

REST API pouze pro čtení vašich vlastních dat: akce, objednávky (včetně vstupenek), návštěvníci (vstupenky se jmény hostů a odbavením) a zákazníci (každý, kdo u vás nakoupil, jeden záznam na e-mailovou adresu). Kompletní referenci najdete na /developers/api.

Vytvoření klíče

Portál → Nastavení → Integrace → API klíče → Vytvořit klíč.

Pojmenujte klíč (např. „Synchronizace HubSpot“) a zvolte, co smí číst.
Potvrďte, že vaše organizace je správcem exportovaných údajů o kupujících.
Klíč si hned zkopírujte – zobrazí se jen jednou. Pokud ho ztratíte, zneplatněte ho a vytvořte nový.

Klíče může vytvářet a zneplatňovat jen vlastník profilu pořadatele. Klíč čte pouze data pořadatele, pro kterého byl vytvořen.

Volání API

Klíč posílejte v hlavičce Authorization:

curl https://tixflow.org/api/v1/orders?createdFrom=2026-10-01T00:00:00Z \
  -H "Authorization: Bearer tf_live_…"

Seznamy vracejí data, nextCursor a hasMore. Dokud je hasMore true, volejte znovu s cursor=<nextCursor>.

Průběžná synchronizace CRM

Řaďte podle updatedAt a uložte si poslední nextCursor. Příště ho pošlete zpět a dostanete jen to, co se změnilo – nové objednávky, vrácení peněz, odbavení.

# first run: everything, oldest change first
GET /api/v1/orders?sort=updatedAt
# store nextCursor; next run, only what changed since:
GET /api/v1/orders?sort=updatedAt&cursor=<stored nextCursor>

Stejný záznam může přijít dvakrát – aktualizujte podle id, nevkládejte nový.
Změny z posledních několika sekund se objeví při dalším volání.
Smazání se nehlásí.

Souhlas s marketingem

Při každém online nákupu může kupující zaškrtnout nepovinné políčko, že chce dostávat vaše novinky. API vrací jeho odpověď jako marketingConsent: true, false, nebo null, pokud se ho nikdo neptal (prodej na místě, starší objednávky). API exportuje všechny kupující bez ohledu na odpověď – co vám dovoluje, rozhodujete jako správce vy.

Limity