Pre prístup k dátam cez REST API Flexi je potrebné poznať identifikátor firmy. Ten zvyčajne vychádza z názvu firmy, pokiaľ nebol názov menený. Identifikátor je vždy jedinečný pre firmu na danom serveri.
Povolené znaky identifikátora sú malé písmená, číslice a podtržník, ostatné znaky v názve firmy sú nahradené práve podtržníkom. Pokiaľ už existuje firma s rovnakým názvom, doplní sa identifikátor o poradové číslo. Pokiaľ teda firmu zálohujete a obnovíte v rovnakom dátovom zdroji, dostane iný identifikátor. Identifikátor zostáva nezmenený, ak firmu premenujete. Pokiaľ firmu vymažete a znovu vytvoríte, môže byť pod rovnakým identifikátorom nová firma.
Existujú dve možnosti, ako získať identifikátor firmy
1) Prihlásime sa do webového rozhrania cez internetový prehliadač a identifikátor firmy zistíme ihneď v adresnom riadku webového prehliadača, v tomto prípade je identifikátor demo_neziskova:
2) Pomocou REST API a HTTP metódy GET požiadavkou na URL server:port/c.xml alebo https://demo.flexibee.eu:5434/c.xml?limit=0, alternatívne pre JSON.
Týmto dotazom do REST API získame kompletný zoznam firiem v XML/JSON. V poli dbNazev zistíme identifikátor, v poli nazev užívateľsky čitateľný názov firmy, ako ho vidíme v aplikácii. Ukážka výstupu:
<companies>
<company>
<createDt>2020-03-05T12:51:18.757+01:00</createDt>
<dbNazev>demo</dbNazev>
<id>-2</id>
<licenseGroup>39fa897328d1e6a55ab199f1410015d2</licenseGroup>
<nazev>Demo firma</nazev>
<show>true</show>
<stavEnum>ESTABLISHED</stavEnum>
<watchingChanges>true</watchingChanges>
</company>
<company>
<createDt>2012-09-10T13:24:49.765+02:00</createDt>
<dbNazev>demo_de</dbNazev>
<id>-2</id>
<licenseGroup>39fa897328d1e6a55ab199f1410015d2</licenseGroup>
<nazev>Já Živnostník</nazev>
<show>true</show>
<stavEnum>ESTABLISHED</stavEnum>
<watchingChanges>true</watchingChanges>
</company>
</companies>
K dispozícii sú ďalšie polia ako dátum vytvorenia (createDt), či je firma prístupná (show) a v akom je stave (stavEnum): ESTABLISHING – zakladanie, ESTABLISHED – aktívna, MAINTENANCE – údržba, alebo či je povolené sledovanie zmien (watchingChanges).