Handleiding / Миграция

Генериране на API ключ в MyTourist

Bijgewerkt op 2026-05-24

Цел

Имате нужда от API ключ + base URL, за да четем Вашите MyTourist данни през нашия миграционен wizard. Ключът дава само достъп за четене — не променяме нищо във Вашия MyTourist.

Стъпка 1 — Влезте в MyTourist

Отидете на app.mytourist.cloud и влезте като администратор на Вашия property.

Стъпка 2 — Навигирайте до Plugins → API

В главното меню вляво: Plugins → API. Ако не виждате елемента от менюто, свържете се с Вашия MyTourist account manager (възможно е ролята Ви да няма достъп до API).

Стъпка 3 — Генерирайте нов ключ

Кликнете + Нов API ключ.

  • Име: въведете BedFlow migratie — удобно за по-късно намиране.
  • Permissions: отметнете само достъп за четене за:
    • bookings
    • debtors
    • invoices
    • roomtypes
    • products
    • vouchers
    • calendar
  • Достъп за писане: оставете всичко изключено. Не ни е необходимо и е ненужен риск.

Кликнете Създай.

Стъпка 4 — Копирайте ключа (виден 1×!)

MyTourist показва ключа само веднъж. Копирайте го веднага или го запишете на сигурно място — ако затворите този прозорец, никога повече няма да го видите и ще трябва да генерирате нов.

Ключът обикновено изглежда така:

mt_live_KX9p7nRm2qLaY8wE1zU4vH6cI0sD9fG2jK4o

Стъпка 5 — Base URL

За повечето акаунти това е:

https://app.mytourist.cloud/api/v1

Променете го само ако MyTourist изрично Ви е дал друг адрес (напр. enterprise клиенти на dedicated поддомейн).

Стъпка 6 — Поставете в BedFlow

На bedflow.eu/migrate (стъпка 2 от wizard-а) поставяте и двете стойности. Кликнете Напред — веднага тестваме дали връзката работи. При грешка получавате ясно съобщение ("Няма връзка — проверете ключа и URL"); при успех преминавате към dry-run preview.

Сигурност

  • Съхранявайте ключа си безопасно: не в Word документ на desktop-а, не в имейл папката. Ние го съхраняваме криптиран до завършване на миграцията и след това го изтриваме автоматично.
  • Един ключ на миграция: създайте отделен ключ за BedFlow, не използвайте същия, който ползвате за други интеграции. Така можете да отнемете точно този, без да засегнете другите Ви flow-ове.
  • Отнемете ключа след onboarding: след успешна миграция можете да изтриете ключа в MyTourist. Тогава ние вече не го пазим.

Какво ако нямам достъп до API?

Някои MyTourist пакети не предлагат достъп до API. Две опции:

  1. Поискайте от MyTourist support — при активен клиент API обикновено се добавя безплатно.
  2. Резервирайте hands-on миграционна сесия с нас (90 €/ч). Помагаме Ви да заявите правилния пакет upgrade или правим миграцията по друг път.
← Terug naar categorie