Actual API Call vs API documentation

[hwcir]

Hi, 

I have a suggestion for the current API documentation. On the Resource API Page, there is a listing of all the available API calls. When I click on the any of the calls, another page opens up which gives details about the call, like input parameters, the sample REST call and other details.

It will be extremely helpful, if you could also add the related API method that is exposed for a developer.

The reason being, that the actual REST call is abstracted away from the developer. When a new developer takes over the project, it is seriously hard to go through the logs to identify each REST call made and the corresponding method exposed in the API. 

For e.g.

https://api.fitbit.com/1/user/-/foods/log/date/2014-12-30.json is the result of FitbitAPIClientService.getFoods(localUser, date)

It will be helpful if you have getFood(localUser, date) mentioned in the API-Get-Foods-Log page (https://wiki.fitbit.com/display/API/API-Get-Food-Logs)

Thanks,

hwcir

[JeremiahFitbit · Accepted solution]

When Fitbit releases official SDKs, we will be sure to do this.

[hwcir]

Thanks! That would be very helpful for the community!