Forecast API FAQ & Error Handling

Updated 1 week ago by Leigh Hutchens

Q: What does “403” error.forecast.forbidden mean?

A: This is caused by one of the following reasons:

  • The credentials you are using are not valid for the environment, customer, or groups you are sending your request.
  • The credentials you are using are only set to "read" and you are trying to do a POST call
    • Check the token response and make sure it is set to "read write"
  • externalUnitId or externalSectionId is not configured in correlation to your API request. Read more about the configuration here.
    • Example of correct set externalUnitId
  • Forecast module is not activated for the customer where the unit you are interacting with belongs.
Q: What does “404” error.forecast.variable.notFound mean?

A: This is caused when the externalForecastVariableId is not found on the customer where the request is made.

Q: When I use the POST command for /raw-data or /forecast-data with the same timestamp, why does it add the data and double the amount I was expecting?

A: If you are sending data again with the same timestamp and want that to overwrite, add the flag appendData=false to the URL of the request.

Q: When I POST data and get a "202" response, I still don’t see the values in the GUI. Why do they show up after a while?

A: Depending on the volume of data that is sent in, and on what granularity we handle the receiving and storing/writing, the data asynchronous. So, it will take a while for large quantities of data to load and be visible in the GUI.

You are also not allowed to use more than 5 concurrent requests (eg. running more than 5 threads simultaneously per unique customer regardless of endpoint).

How Did We Do?