FatSecret Platform API Documentation
Profile - Saved Meals: Add Food To Meal
Description
Adds a food to a user's saved meal according to the parameters specified. The result of the call is the new unique identifier of the newly created saved meal item.
Parameters
All
| NAME | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| method | String | Required | MUST be "saved_meal_item.add" |
| saved_meal_id | Long | Required | Unique saved meal identifier |
| food_id | Long | Required | Unique food identifier |
| saved_meal_item_name | String | Required | New name of the saved meal item |
| serving_id | Long | Required | Unique serving identifier |
| number_of_units | Decimal | Required | Number of units in this standard serving size. For instance, if the serving description is "2 tablespoons" the number of units is "2", while if the serving size is "1 cup" the number of units is "1". Please note that this is only applicable for when food_type is "Generic" whereas for "Brand" the number of units will always be "1" |
| format | String | Optional | The desired response format. Valid response formats are "xml" or "json" (default value is "xml"). |
Response
The only storable value returned by this call is
saved_meal_item_id. Each saved_meal_item_id element contains information as follows:
| NAME | TYPE | DESCRIPTION |
|---|---|---|
| saved_meal_item_id | Long | Unique saved meal item identifier |
Example Response
Example 1:
<?xml version="1.0" encoding="utf-8"?>
<saved_meal_item_id xmlns="http://platform.fatsecret.com/api/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://platform.fatsecret.com/api/1.0/ http://platform.fatsecret.com/api/1.0/fatsecret.xsd">1111111</saved_meal_item_id>Example 1:
{
"saved_meal_item_id": {
"value": "1111111"
}
}Error Codes
| CODE | TYPE | DESCRIPTION |
|---|---|---|
| 2 | OAuth 1.0 | Missing required oauth parameter: '<details>' |
| 3 | OAuth 1.0 | Unsupported oauth parameter: '<details>' |
| 4 | OAuth 1.0 | Invalid signature method: '<details>' |
| 5 | OAuth 1.0 | Invalid consumer key: '<details>' |
| 6 | OAuth 1.0 | Invalid/expired timestamp: '<details>' |
| 7 | OAuth 1.0 | Invalid/used nonce: '<details>' |
| 8 | OAuth 1.0 | Invalid signature: '<details>' |
| 9 | OAuth 1.0 | Invalid access token: '<details>' |
| 101 | Parameter | Missing required parameter: '<details>' |
| 106 | Parameter | Invalid ID: '<details>' |
| 108 | Parameter | Invalid Type: '<details>' |