FitManager на вашата веб-страница (API за веб-страница)

Веќе имате веб-страница што ви се допаѓа? Задржете ја и нека FitManager ја пополни со живи податоци: распоредот на часовите, пакетите за членство со онлајн плаќање, локациите и работното време, блог објавите и контакт и билтен форми што работат. Сè останува ажурно, бидејќи доаѓа директно од контролната табла.

Има два начина:

• Без програмер: залепете краток embed код во веб-страницата и изберете ги виџетите што ви требаат.
• Со програмер: повикувајте ги JSON крајните точки од која било веб-страница или framework.

И двата користат клуч за страница што го создавате во FitManager.

Пред да почнете#

• Пакетот треба да го вклучува API-то за веб-страница.
• Ви треба дозволата Управување со поставки.
• Знајте ја адресата на вашата веб-страница, на пример https://www.vashatateretana.mk.

Создајте клуч за страница#

Под Клучеви за страница, дајте му Име на клучот, на пример страницата за која е.

Под Дозволени потекла, наведете ги адресите на вашата веб-страница, по една во ред.

Кликнете Создај клуч.

Клучот почнува со pk_site_. Копирајте го со копчето до него.

Брз почеток покажува готов код со вашиот клуч. Залепете го embed кодот во вашата веб-страница за да ги прикажете распоредот и пакетите.

Крајни точки покажува што програмерот може да чита и испраќа со клучот.

Следно

Готово

Тоа е сè. Можете да го повторите во секое време.

Почни од почеток

1. Под Клучеви за страница, дајте му Име на клучот, на пример страницата за која е.

2. Под Дозволени потекла, наведете ги адресите на вашата веб-страница, по една во ред.

3. Кликнете Создај клуч.

4. Клучот почнува со pk_site_. Копирајте го со копчето до него.

5. Брз почеток покажува готов код со вашиот клуч. Залепете го embed кодот во вашата веб-страница за да ги прикажете распоредот и пакетите.

6. Крајни точки покажува што програмерот може да чита и испраќа со клучот.

1. Чекор 1: Под Клучеви за страница, дајте му Име на клучот, на пример страницата за која е.
2. Чекор 2: Под Дозволени потекла, наведете ги адресите на вашата веб-страница, по една во ред.
3. Чекор 3: Кликнете Создај клуч.
4. Чекор 4: Клучот почнува со pk_site_. Копирајте го со копчето до него.
5. Чекор 5: Брз почеток покажува готов код со вашиот клуч. Залепете го embed кодот во вашата веб-страница за да ги прикажете распоредот и пакетите.
6. Чекор 6: Крајни точки покажува што програмерот може да чита и испраќа со клучот.

1. Во страничното мени отворете Поставки, Веб-страница, API за веб-страница.
2. Под Клучеви за страница внесете Име, на пример „Главна веб-страница“.
3. Под Дозволени потекла внесете ја адресата на веб-страницата, по една во ред, со https:// и само хостот, без патека: https://www.vashatateretana.mk. Додајте ги и верзијата со www и без, ако страницата одговара на двете.
4. Кликнете Создај клуч.

Новиот клуч се појавува во листата и почнува со pk_site_. Копирајте го со копчето до него.

Клучот за страница е јавен: безбедно е да стои во кодот на веб-страницата, бидејќи чита само она што јавната страница и онака го прикажува, и само од потеклата што сте ги навеле. Оставете ги Дозволени потекла празни само додека тестирате: празна листа дозволува секоја веб-страница да го користи клучот.

Кај секој клуч пишува кога последно е користен. Со Отповикај клучот веднаш престанува да работи, на пример по редизајн; страниците што го користат веднаш престануваат да вчитуваат податоци од FitManager.

Начин 1: embed скриптата (без програмер)#

Картичката Брз почеток на истата страница покажува код со веќе внесен ваш клуч. Залепете го во HTML на веб-страницата, таму каде што сакате да се појави содржината:

<div data-fm-widget="timetable"></div>
<div data-fm-widget="plans"></div>
<script src="https://fitmanager.com/site-embed.js"
  data-key="pk_site_..."
  data-locale="mk"></script>

Копирајте го кодот од вашата страница, а не од тука: тој ги содржи вашиот клуч и вистинската адреса.

Секој <div data-fm-widget="..."> станува еден блок:

Со data-locale="mk" на скриптата добивате македонски, а со data-locale="en" англиски. Виџетите доаѓаат со обичен HTML и класи што почнуваат со fm-, па ги преземаат фонтовите и боите на вашата страница, а вашиот веб-дизајнер може да ги престилизира.

Во градители на веб-страници (WordPress, Wix, Squarespace и слични), залепете го кодот во блок „HTML“, „Custom code“ или „Embed“.

Начин 2: крајните точки (за програмери)#

Картичката Крајни точки ги наведува сите повици. Сите се под https://fitmanager.com/api/site (точниот основен URL е прикажан на вашата страница) и враќаат JSON под data. Клучот се испраќа во заглавието X-Site-Key или како ?key=. Додајте ?locale=mk за македонски текст.

Членовите и понатаму се најавуваат на хостираниот членски портал и плаќаат на хостираната страница за наплата (адресите доаѓаат во GET /gym и GET /plans), па плаќањата со картичка никогаш не минуваат низ вашата веб-страница.

Записите за членови, пријавувањата, купувањата и webhooks не се дел од ова API. За нив треба таен клуч; видете API клучеви.

Чести прашања#

Виџетите се празни или пишуваат „Не може да се вчита во моментов“#

Отворете ја конзолата за програмери во прелистувачот на вашата веб-страница. API-то одговара со причина (на англиски):

• Unknown or revoked site key. Клучот во кодот е погрешен или отповикан. Копирајте го повторно од страницата API за веб-страница.
• This origin is not allowed for the site key. Адресата на веб-страницата не е во Дозволени потекла. Проверете https:// наспроти http:// и www наспроти без www.
• This gym does not have the Site API enabled. Функцијата повеќе не е во вашиот пакет.

„не е валидно потекло“#

Внесете само шема и хост, како https://www.vashatateretana.mk: без патека и без име на страница на крајот.

Дали ми треба и веб-страницата на FitManager?#

Не, но можете да ги чувате двете. Многу теретани ги задржуваат хостираните страници за наплата и членскиот портал, а виџетите ги користат на својата главна страница.