Įrankių prijungimas per API

API leidžia trečiosios šalies programai programiškai prieiti prie jūsų organizacijos duomenų: narių, kalendorių, rezervacijų ir sąskaitų išrašymo. Ji įjungiama dviem paspaudimais ir apsaugoma raktu, leidžiamų adresų sąrašu bei naudojimo stebėjimu.

Santrauka

Ar API skirta jums

API skirta programuotojui, o ne organizacijos vadovui. Ji naudojama tam, kad jūsų paskyra galėtų susikalbėti su programine įranga, kurią rašote ar konfigūruojate: individualiai sukurta interneto svetaine, buhalterine programa, savos gamybos informaciniu ekranu, tarpine sąsaja su kita sistema.

Kasdieniams poreikiams — narių sąrašui gauti, abonementams masiškai atnaujinti, skaičiams valdybai pateikti — pakanka importo, eksporto ir ataskaitų modulių, nerašant nė vienos kodo eilutės.

Importuoti ir eksportuoti naudotojus
Sukurkite arba atnaujinkite savo duomenų bazę per kelias minutes: greitas įvedimas, Excel/CSV failo importas su stulpelių susiejimu, pritaikomas eksportas ir ADOC sinchronizavimas Prancūzijos organizacijoms.
Veiklos ataskaitų gavimas el. paštu
Automatiškai gaukite savo organizacijos gyvenimo suvestinę: narių skaičių, prenumeratas, registracijas, rezervacijas, prisijungimus ir el. laiškus, taip pat pokytį, palyginti su ankstesniu laikotarpiu.

API teikiama beta versija: jos veikimas dar gali kisti.

API įjungimas ir rakto gavimas

  1. Eikite į Administravimas›Nustatymai›API BETA.
  2. Įjunkite Aktyvuoti API modulį ir spustelėkite Išsaugoti.
  3. Rodomas jūsų API raktas: nukopijuokite jį mygtuku Kopijuoti ir perduokite tik tam įrankiui, kurį prijungiate.

Raktas perduodamas kiekvienos užklausos HTTP antraštėje X-API-Key. Užklausos būtinai vykdomos per HTTPS; nešifruotos užklausos nepriimamos.

Rakto apsauga

Šis raktas suteikia visišką administratoriaus prieigą: kortelių skaitymą ir keitimą, paskyrų kūrimą, profilio pakeitimą, prieigos kontrolės kodų peržiūrą. Elkitės su juo kaip su administratoriaus slaptažodžiu — niekada nesiųskite el. paštu, niekada nerašykite pagalbos užklausoje, niekada neįtraukite į ekrano nuotrauką.

Kelias taisykles verta priminti įrankiui ar paslaugų teikėjui, kuris jį naudoja:

  • niekada nekelkite rakto į kodo saugyklą; laikykite jį konfigūracijos faile už saugyklos ribų arba slaptų duomenų valdymo priemonėje;
  • apribokite leidžiamus adresus, kai tik įrankis siunčia užklausas iš fiksuoto serverio;
  • sugeneruokite raktą iš naujo esant bet kokiam įtarimui — atsitiktinis paskelbimas, žurnalų nutekėjimas, paslaugų teikėjo darbo pabaiga.

Mygtukas Regeneruoti paprašo patvirtinimo ir tuoj pat paskelbia senąjį raktą negaliojančiu. Visos jį naudojusios programos nustos veikti, kol negaus naujojo: informuokite jas prieš spustelėdami.

Per API pasiekiami duomenys apima asmeninę informaciją: tapatybę, adresą, telefoną, gimimo datą, medicininę pažymą. Už jų tvarkymą atsako jūsų organizacija. Atverkite API tik tai trečiajai šaliai, su kuria ši atsakomybė yra oficialiai sutvarkyta.

Prieigos apribojimas pagal IP adresą

Įjunkite Apribojimas pagal IP adresą: priimamos tik iš jūsų nurodytų adresų atėjusios užklausos, ne daugiau kaip 10 IPv4 adresų. Įrašykite kiekvieną adresą ir patvirtinkite mygtuku Pridėti; jums padėti ekrane rodomas jūsų dabartinis adresas.

Tai veiksmingiausia ir dažniausiai užmirštama apsauga: net atskleistas raktas, apribotas jūsų paslaugų teikėjo adresu, kitur bus nenaudingas.

Įjunkite apribojimą tik tada, kai užklausas siunčiančio serverio adresas žinomas ir nesikeičia. Kintantis adresas — namų interneto ryšys, programuotojo kompiuteris — nutrauks prieigą be jokio įspėjimo.

Naudojimo stebėjimas

Ekrane nuolat rodoma, kiek naudoja jūsų raktas:

  • Naudojimas šią minutę ir Naudojimas šiandien, kiekvienas lyginamas su savo riba, kai riba yra nustatyta;
  • Naudojimo statistika: Šią savaitę, Šis mėnuo, Iš viso ir Paskutinis užklausa.

Pasiekus nurodytas ribas, papildomos užklausos laikinai atmetamos. Skaitiklis, kuris nuolat artinasi prie savo viršutinės ribos, paprastai rodo netinkamai sukonfigūruotą įrankį, kuris be perstojo prašo tų pačių duomenų, užuot juos kaupęs podėlyje.

Paskutinės užklausos data naudinga kita linkme: įjungtas raktas, kuriuo mėnesius nesiųsta nė viena užklausa, yra raktas, kurį reikia išjungti.

Ką leidžia API

Visa dokumentacija su parametrais ir užklausų pavyzdžiais rodoma modulio ekrano apačioje. Trumpai:

  • Naudotojai: tai vienintelis keičiamas išteklius. Galite peržiūrėti sąrašą, atverti, kurti, keisti ir naikinti paskyras.
  • Konfigūracija: abonementus, profilius, grupes ir amžiaus kategorijas galima peržiūrėti, bet konfigūruoti tik programoje.
  • Rezervacijos: galima peržiūrėti kalendorius, laisvus laiko intervalus, rezervacijas ir etiketes.
  • Sąskaitų išrašymas: galima peržiūrėti sąskaitų išrašymo paskyras, užsakymus ir mokėjimus.
Prieš kurdami integraciją įsidėmėkite šią asimetriją: viską galima skaityti, o įrašyti galima tik naudotojų paskyras. Įrankis, kuris turėtų kurti abonementus ar etiketes, per API to padaryti negalės.
Kasdienis naudotojų valdymas
Naudotojų valdymas sutelkia visas jūsų organizacijos korteles: kontaktinius duomenis, prisijungimo duomenis, abonementą, kreditus, pastabas ir šiukšliadėžę. Tai jūsų atskaitos taškas visiems kasdieniams veiksmams.
Sąskaitos faktūros ir operacijos
Sekite visus savo organizacijos pardavimo dokumentus — komercinius pasiūlymus, užsakymus ir sąskaitas faktūras — priimkite mokėjimus, atlikite grąžinimus ir eksportuokite pardavimus buhalterijai. Eikite į meniu Administravimas›Valdymo skydelis›Sąskaitų išrašymas›Sąskaitos ir sandoriai.
Veiklos ataskaitos
Prieigos kontrolė
Atnaujinta 2026 m. rugpjūtis 5 d., trečiadienis
Sąlygos ir privatumo politika
Lietuva (LT)