API-Basics

authentication you can find the api key in the frontu system by going to the settings > api tab and there you will find your api key, which you can use to authenticate via url parameter in this case you need to set access token and fill your generated api key example https //somedomain frontu com/client/api/v2/evaluations/task?access token=mje5zwq2ytfhztczmjixnjnhnty3zgrjnjnjm2jkzddhmtm1zgyyndhmy2zkyja2m2y4ntqznzflntnhnjdkoa\&guid=f889fbe9 9d9b 3c8a 8549 e321ee7e3e34 https //somedomain frontu com/client/api/v2/evaluations/task?access token=mje5zwq2ytfhztczmjixnjnhnty3zgrjnjnjm2jkzddhmtm1zgyyndhmy2zkyja2m2y4ntqznzflntnhnjdkoa\&guid=f889fbe9 9d9b 3c8a 8549 e321ee7e3e34 for the header authentication you need to set key = authorization value = bearer mje5zwq2ytfhztczmjixnjnhnty3zgrjnjnjm2jkzddhmtm1zgyyndhmy2zkyja2m2y4ntqznzflntnhnjdkoa guid / systemid logic guid is a unique identifier generated by frontu systemid is a unique identifier from the system you’re integrating frontu with question why using systemid makes integration easier (easy mapping with systemx)? to make an integration easier we recommend to use the systemid field which should have the same value as it has in the system you’re integrating with in this case you will not need to store and additionally map items between the systems important systemid is a unique value, so make sure you don’t have duplicate values in your system create / update item while sending data using a post method to the api, frontu tries to identify it in the first stage, frontu tries to find an item by guid if it is provided secondly by systemid if such an item exists in the frontu database, it will be updated, or otherwise created deleted flag frontu provides only a soft delete option to keep data integrity to make an item “archived” you have to change the value of the “deleted” field 1 means that item is archived 0 means that item is active version field logic frontu gathers a big amount of data to make sure you would not need to synchronize all of it every time you can use the “version” field to filter it “version” field value is a unix timestamp value (utc timezone) which defines the last time an item has been updated e g 1623830251 filters it allows to filter data via query params for example, you want to get detailed info about tasks in this case, you can fill in information like guid in the query params, systemid, bill status, task status, or flag which allows you to filter tasks if they are received by an external system, task code, and version if you fill in information about one of these params you will get filtered data according to these parameters limitation we are limiting the number of requests from one ip address > up to 1000 requests from one ip within 5 min