background image

 
 

 
 

F100327-04

 

 

 

 

 

API Documentation 

 

      

3.0 Export Footfall Data to Retailer System 

3.1 Pull Data via API from counter  

 

The camera automatically collects the traffic data and builds them into a convenient JSON/XML data file that can be retrieved easily via a web 
service API call, hence allowing seamless integration of the camera into any existing solution. Through an API call, the data file will be extracted 
from FootfallCam portal to the business intelligence system for further data processing in order to generate the management report. 

 

3.1.1 Counter API Terminology and Parameters 

 

For counter data we use following terminology and parameters: 

 

Parameter 

Default 

Description 

Value 

Sample 

data_type 

json 

Type of the data 

json, xml 

data_type=xml 

data_format 

Hour 

Format of the data 

hour, minute, second 

data_format=second 

date_start 

Yesterday’s 

date 

Start Date of the data 

YYYMMDD 

date_start=20181231 

date_end 

End Date of the data 

YYYYMMDD 

date_end=20190228 

resolution_min 

The minutes data’s 

resolution (Minutes data 

only) 

1, 5, 10, 15, 30, 60 

resolution_min=15 

resolution_sec 

10 

The second data’s 

resolution (Only available 

for counter running firmware 

version 3.2.0) 

1, 5, 10, 15, 30, 60 

resolution_sec=1 

time_start 

1 day [0:00] 

To set the start time range 

of the API 

HHmmss 

time_start=103000 

time_end 

1 day [23:59] 

To set the end time range of 

the API 

HHmmss 

time_end=223300 

 

 

 

 

 

Note: 

The maximum amount of data you can get from time range is 24 hours. Both time range start and end should be set. 

time_start is set, but time_end is not = default time_end will be 1 hour after time_start 

time_end is set, but time_start 

is not = default time_start will be “000000”

 

Summary of Contents for 3D Plus

Page 1: ...F100327 04 API Documentation 1 F100327 04...

Page 2: ...cument contains confidential and propriety information belonging exclusively to FootfallCam International Inc No confidential or propriety information contained in this publication may be reproduced s...

Page 3: ...F100327 04 API Documentation 3 Table of Contents 1 0 Overview 4 2 0 Authentication API 5 3 0 Export Footfall Data to Retailer System 6...

Page 4: ...es footfall data from FootfallCam central server together with ePOS data or staff labour hours from retailer s ePOS system or staff management system to produce management report for corporate strateg...

Page 5: ...username and password Sample Call http ip port cgi bin access_token cgi username yourusername password yourpassword Sample Respond Note The access token does not have any expiry date its vary from use...

Page 6: ...json xml data_type xml data_format Hour Format of the data hour minute second data_format second date_start Yesterday s date Start Date of the data YYYMMDD date_start 20181231 date_end End Date of the...

Page 7: ...ate_start 20180612 time_start 083000 time_end 183000 data_type json data_format second resolution_sec 30 access_to ken token Method GET URL Paramete rs Optional Name Value Descriptions Date Omit Singl...

Page 8: ...cess Response xml Note If time range is selected you can maximumly select one day data per request Note Retrieving data in seconds resolution from the FootfallCam counter level is only usable by count...

Page 9: ...ount number of Out count URL Json http ip port cgi bin apiCount cgi data_type json resolution_min 1 data_format minute access_token token Method GET URL Parameters Optional Name Value Descriptions Dat...

Page 10: ...F100327 04 API Documentation 10 Success Response xml Note You can only obtain one day minute data per request...

Page 11: ...ount URL Json http ip port cgi bin apiCount cgi data_type json data_format hour access_token token Method GET URL Parameters Optional Name Value Descriptions Date omit Single day YYYYMMDD Omit Date ra...

Page 12: ...F100327 04 API Documentation 12 Success Response xml Note You can choose to obtain single day or date range...

Page 13: ...anchlist Branch dataincludeBranchId Name Region City Country StoreType Latitude LongitudeandFloorSize Function Name GetBranchList Method SQL DataParams Username nvarchar Password nvarchar Success Resp...

Page 14: ...0 20150321 Notes 1 refertotheall branches inthecompany 3 2 3 How to Get Daily Counting Data by Branch Title Get BranchDaily Counting Data Description SQLFunctiontoretrievedailysummaryfilteredbycounter...

Reviews: