3 Minute Read
Below are some Use cases from Developer Portal for API's
1. How do I authenticate my app?
As a external user or developer, You can access the Developer Portal using Home - 75F - Developer portal
The welcome page of the developer portal provides the user with 2 options as follows:
- Option to sign-up for the portal
- Option to explore the API's
You can access APIs, Products from the welcome page, only if you are a signed in user.
- Click Sign up if you are a first time user, else click sign in.
The Sign up screen is displayed.
Enter the required details and confirm that you are not a robot by entering the CAPTCHA characters provided.
- Click Sign Up and Confirm
"User registered successfully" message screen is displayed with instructions to follow and option to sign- in is displayed.
A welcome email is generated and sent to the user email
You can access the portal using the link provided in the email, or using the Sign in option in the registration confirmation screen.
- Sign in with the email ID and password that was provided during registration and click Sign in.
Post Authentication
The remaining use cases assume that you've already authenticated and have your access token. Some FAQ's are addressed below:
(a) How do I understand how Project Haystack works?
You can visit the official website for Project Haystack to know more about how Project Haystack works. The link to the website can be found on Home – Project Haystack (project-haystack.org)
(b) How do I understand how tags are used in project Haystack?
The link to the complete list of Project Haystack tags is given below:
tags – Project Haystack (project-haystack.org)
(c) How do I know more about the haystack equips, points within the 75F system?
The External Developer needs to log into Facilisight portal using the credentials set and the navigate to Site explorer tool available under Site>Left Pane>Site Explorer
(d) What is my zone's actual temperature?
Use the query https://api-management-75f-dev.azure-api.net/ph/read?id@84ac3766-9b8d-4133-8c7c-9790aedd6e0f if the ID of the zone current temp sensor is known.
If the ID is not known, else Use the query https://api-management-75f-dev.azure-api.net/ph/read?filter=zone and current and Temp and sensor
Once the list all zone current temp is obtained, the developer needs to find which is their zone of interest and apply that value.
(e) What is the configured mode of my CCU system (heat/cool/off)?
Use the query https://api-management-75f-dev.azure-api.net/ph/read?id@84ac3766-9b8d-4133-8c7c-9790aedd6e0f if the ID of the Occupancy Mode Point is known.
If the ID of the Occupancy mode point is not known, else use the query https://api-management-75f-dev.azure-api.net/ph/read?filter=system and occupancy and mode
Once the list all zone current temperature is obtained, the developers needs to find which is their zone of interest and then use that value.
(f) How do I get a historical runtime of all co2 sensor values from all my zones at my site from September first to October 29th 2021 (for a specific time period)?
To obtain a historic runtime for a specific period, use the query if the ID of the Co2 sensor values points across all zones is known
Comments
0 comments
Please sign in to leave a comment.