/// <summary>
/// Parses the error structure which is common when errors are raised from the api
/// </summary>
/// <param name="serializer"></param>
/// <param name="errorJson"></param>
/// <returns></returns>
internal static List <ApiError> ParseErrors(this JsonDotNetSerializer serializer, string errorJson)
{
if (string.IsNullOrWhiteSpace(errorJson))
{
throw new ArgumentNullException(nameof(errorJson), "errorJson can not be empty, null or whitespace");
}
serializer.RootProperty = "errors";
return(serializer.Deserialize <List <ApiError> >(errorJson));
}
/// <summary>
/// Set the Goals for the current logged in user; individual goals, multiple or all can be specified in one call.</summary>
/// <param name="caloriesOut"></param>
/// <param name="distance"></param>
/// <param name="floors"></param>
/// <param name="steps"></param>
/// <param name="activeMinutes"></param>
/// <returns></returns>
public async Task <ActivityGoals> SetGoalsAsync(int caloriesOut = default(int), decimal distance = default(decimal), int floors = default(int), int steps = default(int), int activeMinutes = default(int))
{
// parameter checking; at least one needs to be specified
if ((caloriesOut == default(int)) &&
(distance == default(decimal)) &&
(floors == default(int)) &&
(steps == default(int)) &&
(activeMinutes == default(int)))
{
throw new ArgumentException("Unable to call SetGoalsAsync without specifying at least one goal parameter to set.");
}
var messageContentParameters = new Dictionary <string, string>();
if (caloriesOut != default(int))
{
messageContentParameters.Add("caloriesOut", caloriesOut.ToString());
}
if (distance != default(decimal))
{
messageContentParameters.Add("distance", distance.ToString());
}
if (floors != default(int))
{
messageContentParameters.Add("floors", floors.ToString());
}
if (steps != default(int))
{
messageContentParameters.Add("steps", steps.ToString());
}
if (activeMinutes != default(int))
{
messageContentParameters.Add("activeMinutes", activeMinutes.ToString());
}
var apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/-/activities/goals/daily.json");
//caloriesOut=100&distance=1.0&floors=1&steps=8000&activeMinutes=10
HttpResponseMessage response = await HttpClient.PostAsync(apiCall, new FormUrlEncodedContent(messageContentParameters));
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var seralizer = new JsonDotNetSerializer {
RootProperty = "goals"
};
return(seralizer.Deserialize <ActivityGoals>(responseBody));
}
/// <summary>
/// Get the set body measurements for the date value and user specified
/// </summary>
/// <param name="date"></param>
/// <param name="encodedUserId"></param>
/// <returns></returns>
public async Task <BodyMeasurements> GetBodyMeasurementsAsync(DateTime date, string encodedUserId = default(string))
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/{0}/body/date/{1}.json", encodedUserId, date.ToFitbitFormat());
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer();
return(serializer.Deserialize <BodyMeasurements>(responseBody));
}
/// <summary>
/// Requests the lifetime activity details of the encoded user id or none supplied the current logged in user
/// </summary>
/// <param name="encodedUserId">encoded user id, can be null for current logged in user</param>
/// <returns></returns>
public async Task <ActivitiesStats> GetActivitiesStatsAsync(string encodedUserId = null)
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/{0}/activities.json", encodedUserId);
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer();
return(serializer.Deserialize <ActivitiesStats>(responseBody));
}
/// <summary>
/// Gets the water date for the specified date - https://wiki.fitbit.com/display/API/API-Get-Water
/// </summary>
/// <remarks>
/// GET https://api.fitbit.com/1/user/-/foods/log/water/date/yyyy-mm-dd.json
/// </remarks>
/// <param name="date"></param>
/// <returns></returns>
public async Task <WaterData> GetWaterAsync(DateTime date)
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/{0}/foods/log/water/date/{1}.json", args: date.ToFitbitFormat());
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer();
return(serializer.Deserialize <WaterData>(responseBody));
}
/// <summary>
/// Requests the devices for the current logged in user
/// </summary>
/// <returns>List of <see cref="Device"/></returns>
public async Task <List <Device> > GetDevicesAsync()
{
var apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/-/devices.json");
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer();
return(serializer.Deserialize <List <Device> >(responseBody));
}
/// <summary>
/// Requests the activity details of the encoded user id or if none supplied the current logged in user for the specified date
/// </summary>
/// <param name="activityDate"></param>
/// <param name="encodedUserId">encoded user id, can be null for current logged in user</param>
/// <returns>FitbitResponse of <see cref="ActivitySummary"/></returns>
public async Task <Activity> GetDayActivityAsync(DateTime activityDate, string encodedUserId = null)
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/{0}/activities/date/{1}.json", encodedUserId, activityDate.ToFitbitFormat());
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer();
return(serializer.Deserialize <Activity>(responseBody));
}
/// <summary>
/// Gets a list of the current subscriptions for the current logged in user
/// </summary>
/// <returns></returns>
public async Task <List <ApiSubscription> > GetSubscriptionsAsync()
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/-/apiSubscriptions.json");
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer {
RootProperty = "apiSubscriptions"
};
return(serializer.Deserialize <List <ApiSubscription> >(responseBody));
}
/// <summary>
/// Requests the user profile of the encoded user id or if none specified the current logged in user
/// </summary>
/// <param name="encodedUserId"></param>
/// <returns><see cref="UserProfile"/></returns>
public async Task <UserProfile> GetUserProfileAsync(string encodedUserId = default(string))
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/{0}/profile.json", encodedUserId);
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer {
RootProperty = "user"
};
return(serializer.Deserialize <UserProfile>(responseBody));
}
/// <summary>
/// Requests the sleep data for the specified date for the logged in user
/// </summary>
/// <param name="sleepDate"></param>
/// <returns></returns>
public async Task <SleepData> GetSleepAsync(DateTime sleepDate)
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/{0}/sleep/date/{1}.json", args: sleepDate.ToFitbitFormat());
HttpResponseMessage response = await HttpClient.GetAsync(apiCall);
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer();
var data = serializer.Deserialize <SleepData>(responseBody);
FitbitClientExtensions.ProcessSleepData(data);
return(data);
}
public static OAuth2AccessToken ParseAccessTokenResponse(string responseString)
{
// assumption is the errors json will return in usual format eg. errors array
JObject responseObject = JObject.Parse(responseString);
var error = responseObject["errors"];
if (error != null)
{
var errors = new JsonDotNetSerializer().ParseErrors(responseString);
throw new FitbitException($"Unable to parse token response in method -- {nameof(ParseAccessTokenResponse)}.", errors);
}
var deserializer = new JsonDotNetSerializer();
return(deserializer.Deserialize <OAuth2AccessToken>(responseString));
}
/// <summary>
/// Logs the specified WaterLog item for the current logged in user - https://wiki.fitbit.com/display/API/API-Log-Water
/// </summary>
/// <param name="date"></param>
/// <param name="log"></param>
/// <returns></returns>
public async Task <WaterLog> LogWaterAsync(DateTime date, WaterLog log)
{
string apiCall = FitbitClientHelperExtensions.ToFullUrl("/1/user/-/foods/log/water.json");
var items = new Dictionary <string, string>();
items.Add("amount", log.Amount.ToString());
items.Add("date", date.ToFitbitFormat());
apiCall = string.Format("{0}?{1}", apiCall, string.Join("&", items.Select(x => string.Format("{0}={1}", x.Key, x.Value))));
HttpResponseMessage response = await HttpClient.PostAsync(apiCall, new StringContent(string.Empty));
await HandleResponse(response);
string responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer {
RootProperty = "waterLog"
};
return(serializer.Deserialize <WaterLog>(responseBody));
}
/// <summary>
/// Add subscription
/// </summary>
/// <param name="apiCollectionType"></param>
/// <param name="uniqueSubscriptionId"></param>
/// <param name="subscriberId"></param>
/// <returns></returns>
public async Task <ApiSubscription> AddSubscriptionAsync(APICollectionType apiCollectionType, string uniqueSubscriptionId, string subscriberId = default(string))
{
string path = FormatKey(apiCollectionType, Constants.Formatting.TrailingSlash);
string resource = FormatKey(apiCollectionType, Constants.Formatting.LeadingDash);
string url = "/1/user/-/{1}apiSubscriptions/{3}{2}.json";
string apiCall = FitbitClientHelperExtensions.ToFullUrl(url, args: new object[] { path, resource, uniqueSubscriptionId });
if (!string.IsNullOrWhiteSpace(subscriberId))
{
HttpClient.DefaultRequestHeaders.Add(Constants.Headers.XFitbitSubscriberId, subscriberId);
}
HttpResponseMessage response = await HttpClient.PostAsync(apiCall, new StringContent(string.Empty));
await HandleResponse(response);
var responseBody = await response.Content.ReadAsStringAsync();
var serializer = new JsonDotNetSerializer();
return(serializer.Deserialize <ApiSubscription>(responseBody));
}
