Wiki / Nápověda

Praktický návod ke všem funkcím Sedneme si: hledání spojů, sedadla, shody, hlídače míst, profil, doporučovací program a rozhraní pro AI asistenty.

Otevřít aplikaci

Obsah

Hledání spojůVýběr spoje a rezervaceJedu tímhle spojem a sedadlaShody a žádostiHlídač místGoogle přihlášení a profilAffiliate 50/50Pro AI agenty a asistentyFAQ

Hledání spojů

  1. Zadej město odjezdu, město příjezdu, datum a čas.
  2. Vyber dopravce: libovolný, FlixBus, České dráhy, RegioJet nebo Leo Express.
  3. Klikni na „Najít dostupné spoje“.
  4. Výsledky se řadí podle času a zobrazují dostupnost, pokud ji API pro daný zdroj zná.

Co znamená obsazenost

  • RegioJet: u živého zdroje se načítá dostupnost i mapa sedadel přes backend API.
  • FlixBus: dostupná místa se zobrazí, pokud je vrátí datový konektor.
  • České dráhy a Leo Express: web může zobrazit spoj z katalogu nebo jízdního řádu, ale bez potvrzené obsazenosti.
  • Vyprodáno: pokud zdroj vrátí nula volných míst, karta spoj označí jako vyprodaný.
Web si nevymýšlí konkrétní místa ani obsazenost. Když data nejsou dostupná, je to v UI výslovně napsané.

Výběr spoje a rezervační odkazy

  1. Na kartě spoje klikni na „Jedu tímhle spojem“.
  2. Pokud backend dodá přesný rezervační odkaz, tlačítko vede přímo na ověřený booking.
  3. Když přesný odkaz není dostupný, tlačítko otevře oficiální web dopravce a u karty je jasně napsáno, že jde o fallback.
  4. Vždy si v systému dopravce zkontroluj trasu, datum, čas a spoj před nákupem.

Jedu tímhle spojem a výběr sedadla

RegioJet

  1. Po kliknutí na „Jedu tímhle spojem“ frontend zavolá /api/connections/<id>/seats.
  2. Zobrazí se reálná mapa podle vozů.
  3. Klikací jsou jen volná sedadla.
  4. Místa označená jiným uživatelem Sedneme si jsou zvýrazněná a mají vysvětlení v titulku.
  5. U RegioJetu bez vybraného sedadla nejde cestu uložit.

Ostatní dopravci

  1. Zadej číslo sedadla z rezervace.
  2. Vůz je nepovinný. Když ho znáš, uložení použije tvar vůz/sedadlo.
  3. Obsazenost sedadel se u těchto dopravců neověřuje v mapě.

Shody a žádosti

  • Shoda vychází ze stejné trasy, data, spoje a z preferencí cestujících.
  • Skóre je orientační pomůcka pro řazení kandidátů.
  • Kontakt je skrytý, dokud obě strany nepotvrdí zájem.
  • Po potvrzení se v sekci Moje cesta zobrazí bezpečně uložený kontakt.
  • Soukromí: veřejně se nezobrazuje e-mail ani telefon bez oboustranného potvrzení.

Hlídač míst

  1. Vyhledej a vyber spoj.
  2. Do kontaktního pole zadej platný e-mail nebo telefon.
  3. Vyber preferenci: jakékoliv volné místo, u okna, u průchodu, se stolkem, tichý vůz, se zásuvkou nebo vedle sebe.
  4. Klikni na „Zapnout hlídač“.
  5. Po přihlášení uvidíš hlídače v Mém profilu a můžeš je zrušit.

Google přihlášení a Můj profil

  • Přihlášení probíhá přes Google Identity Services.
  • Server ukládá session cookie; heslo Google nikdy nezadáváš do Sedneme si.
  • V profilu jsou moje cesty, hlídače a případný affiliate blok.
  • U hlídačů je tlačítko „Zrušit“, které volá vlastnický cancel endpoint.

Affiliate program 50/50

  1. V sekci Affiliate zadej jméno, kontakt a volitelně kanál.
  2. Server vrátí kód a odkaz ve tvaru https://sedneme-si.cz/?ref=KOD.
  3. Při otevření odkazu se referral uloží na 30 dní do prohlížeče a zapíše se klik.
  4. Při uložení cesty se referral kód přidá do payloadu.
  5. Provize je 50 % z reálných výnosů doporučených uživatelů; výnosy jsou zatím ve výstavbě a nyní se eviduje provoz.

Pro AI agenty a asistenty

Služba zveřejňuje strojově čitelné popisy:

  • /api/docs — JSON popis veřejných endpointů.
  • /mcp — MCP Streamable HTTP endpoint přes JSON-RPC 2.0.
  • /llms.txt a /llms-full.txt — textový popis služby pro asistenty.

Příklad MCP initialize

POST /mcp
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"agent","version":"1.0"}}}

Příklad tools/list

POST /mcp
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

Příklad tools/call

POST /mcp
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_connections","arguments":{"from":"Praha","to":"Brno","date":"2026-07-04","operator":"regiojet"}}}

Agenti nesmí tvrdit přesná místa, ceny nebo rezervační URL bez ověření v API nebo v renderovaném webu dopravce.

FAQ

1. Je Sedneme si dopravce?

Ne. Je to pomocná služba pro hledání spojů, ukládání cest, shody a hlídání míst.

2. Kdy vidím přesné sedadlo?

U RegioJetu při dostupné mapě sedadel. U ostatních dopravců zadáváš sedadlo ručně podle rezervace.

3. Co když je spoj vyprodaný?

Karta ho označí jako vyprodaný, pokud takový stav vrátí zdroj dat.

4. Ukazujete smyšlenou obsazenost?

Ne. Když obsazenost není dostupná, UI to napíše.

5. Kdy se zobrazí můj kontakt?

Až po oboustranném potvrzení žádosti.

6. Jak zruším hlídač?

Po přihlášení otevři Můj profil a u konkrétního hlídače klikni na „Zrušit“.

7. Jak funguje affiliate tracking?

Referral kód z URL se uloží v prohlížeči na 30 dní a při uložení cesty se pošle serveru.

8. Je API veřejné?

Veřejná read-only dokumentace je na /api/docs. MCP endpoint /mcp je určen pro asistenty a podporuje vyhledání spojů, mapu sedadel a health check.

9. Co znamená fallback rezervační odkaz?

Znamená, že se otevře oficiální web dopravce, ale konkrétní spoj musíš zkontrolovat ručně.

10. Musím být přihlášený?

Pro základní uložení cesty ne vždy, ale profil, vlastnické rušení hlídačů a pohodlné přenášení cest vyžadují přihlášení.