Ekonomický systém ABRA Flexi umožňuje použiť kontakty uložené v databáze na autentizáciu.
Pomocou API je najskôr nutné kontaktu nastaviť meno a heslo. Existujú dva spôsoby:
Heslo je možné zaslať vo forme plain-text:
Heslo je možné zaslať vo forme výsledku volania hash funkcie. V tomto prípade sú povinné parametre salt a typ hash funkcie:
Potom je možné pomocou API autentizovať kontakt volaním:
POST /c/firma/kontakty/1/authenticate Accept: application/xml Content-Type: application/x-www-form-urlencoded username=jan&password=heslo
Autentizácia funguje aj na všeobecnej URL kontaktov:
POST /c/firma/kontakt/authenticate Accept: application/xml Content-Type: application/x-www-form-urlencoded username=jan&password=heslo
Výsledkom je vždy odpoveď s HTTP status kódom 200, výsledok je uvedený v tele odpovede:
Úspešná autentizácia:
<?xml version="1.0"?><winstrom version="1.0"> <success>true</success> <message/></winstrom>
Neúspešná autentizácia:
<?xml version="1.0"?><winstrom version="1.0"> <success>false</success> <message>Bylo zadáno chybné uživatelské jméno či heslo.</message></winstrom>