Actofit SmartScale Business APP API

Actofit Smartscale Business app is best suited for dietitians, nutritionist, health clinics, gyms and fitness clubs, wherein database management becomes an uphill task due to more and more people turning up every day. Now, create, store, organise and manage data points on your device for endless users, all within our app. All the data collected in this app is also available over the API

How to use this API

  1. Install and Login into the Actofit Smartscale Business app
  2. Create the members profile into the app from “Add user page” in the app
  3. While adding the user you must enter member’s email address or mobile number as it is needed for user identification over the API
  4. Ask the member to stand on the scale bare foot and select that members profile from the user page, Member should stand on the scale till the complete analysis gets over and all 15 body composition parameters get displayed on the app
  5. Now these 15 body composition parameters data can be fetched through the REST API
  6. To access this API you will need a authentication token, Please email us at support@actofit.com or feel the API registration form
  7. To fetch any members data you must pass the member’s email address or mobile number to the API
  8. Based on the email address or mobile number the member’s unique user id will be provided (Get member id API)
  9. By using member’s unique id you can fetch member’s entire body composition data in json format (Get member data API)

Get member id API

This api will provide the member’s unique identification number (user_id) based on the member’s email address or mobile number

Architectural Style: REST

Request type: POST

API Endpoint: http://smartscaleapi.actofit.com:3030/auth_search_by_email

Request Body:

key {email_id}        value {enter member’s email or mobile no here}

key {token}             value {enter the token provided by Actofit here}

Response on success:

{
“code”: 1,
“message”: “”,
“user_list”: [
{
“user_id”: 27017,
“user_name”: “mike”,
“user_type”: “child”
} ] }

Error Response:

  • If invalid token is entered

{
“code”: 0,
“error”: “Enter valid token”
}

  • If invalid email is entered

{
“code”: 0,
“message”: “Oops!!”,
“user_list”: []
}

Get member data API

This api will provide the member’s body composition analysis data (15 body composition parameters) based on the member’s unique identification number (user_id)

Architectural Style: REST

Request type: POST

API Endpoint: http://smartscaleapi.actofit.com:3030/auth_get_user_readings

Request Body:

key {user_id}        value {enter member’s user_id from get member id API here}

key {token}           value {enter the token provided by Actofit here}

Response on success:

{
“code”: 1,
“message”: “”,
“userData”: [
{
“id”: 2240,
“user_id”: 12344434787,
“timestamp”: 1513405663000,
“device_name”: “”,
“device_id”: “”,
“weight”: “50.95”,
“bmi”: “21.2”,
“body_fat”: “35.4”,
“physique”: “1”,
“fat_free_weight”: “32.9”,
“subcutaneous_fat”: “33.3”,
“visceral_fat”: “5”,
“body_water”: “44.3”,
“skeletal_muscle”: “37.6”,
“muscle_mass”: “30.9”,
“bone_mass”: “2.0”,
“protein”: “14.6”,
“bmr”: “1080.5”,
“metabolic_age”: “20”,
“health_score”: “0”,
“created_date”: “16 – 12 – 2017”
},
{
“id”: 2241,
“user_id”:12344434787,
“timestamp”: 1513405693000,
“device_name”: “”,
“device_id”: “”,
“weight”: “50.95”,
“bmi”: “21.2”,
“body_fat”: “0.0”,
“physique”: “0”,
“fat_free_weight”: “0.0”,
“subcutaneous_fat”: “0.0”,
“visceral_fat”: “0”,
“body_water”: “0.0”,
“skeletal_muscle”: “0.0”,
“muscle_mass”: “0.0”,
“bone_mass”: “0.0”,
“protein”: “0.0”,
“bmr”: “0.0”,
“metabolic_age”: “0”,
“health_score”: “0”,
“created_date”: “16 – 12 – 2017”
}

Error Response:

  • If invalid token is entered

{
“code”: 0,
“error”: “Enter valid token”
}

  • If invalid user_id is entered

{
“code”: 0,
“message”: “Oops!!”,
“user_list”: []
}

Parameters Measured by Actofit SmartScale Business APP

Body Weight:
Users body weight is measured with higher accuracy. The maximum weight that the smart scale can measure is 210Kg.

Body Fat Percentage:
The body fat percentage (BFP) of a human or other living being is the total mass of fat divided by total body mass, multiplied by 100; body fat includes essential body fat and storage body fat. The body fat percentage is a measure of fitness level.

Visceral Fat:
Visceral fat is located deep in the core abdominal area, surrounding and protecting the vital organs. Even if your weight and body fat remains constant, as you get older the distribution of fat changes and is more likely to shift to the abdominal area. Ensuring you have a healthy level of visceral fat directly reduces the risk of certain diseases such as heart disease, high blood pressure and may delay the onset of type 2 diabetes.

Muscle Mass:
The predicted weight of muscle in your body. Muscle mass includes the skeletal muscles, smooth muscles such as cardiac and digestive muscles and the water contained in these muscles. Muscles act as an engine in consuming energy. As your muscle mass increases, the rate at which you burn energy (calories) increases which accelerates your basal metabolic rate (BMR) and helps you reduce excess body fat levels and lose weight in a healthy way.

Total Body Water:
Total Body Water is the total amount of fluid in the body expressed as a percentage of total weight. Body water is an essential part of staying healthy. Over half the body consists of water. It regulates body temperature and helps eliminate waste.

Bone Mass:
The predicted weight of bone mineral in your body. While your bone mass is unlikely to undergo noticeable changes in the short term, it’s important to maintain healthy bones by having a balanced diet rich in calcium and by doing plenty of weight-bearing exercises.

Physique Rating:
The amount of muscle and body fat levels decides your physique rating. Depending on physique rating human body type can be differentiated in nine body types. As your activity level changes, the balance of body fat and muscle mass will gradually change, which in affects your overall physique.

Basal Metabolic Rate (BMR):
The daily minimum level of energy or calories your body requires when at rest (including sleeping) in order to function effectively. Increasing muscle mass will speed up your basal metabolic rate (BMR). A person with a high BMR burns more calories at rest than a person with a low BMR.

Metabolic Age:
Metabolic age is calculated by comparing your basal metabolic rate (BMR) to the BMR average of your chronological age group. If your metabolic age is higher than your actual age, it’s an indication that you need to improve your metabolic rate.

Body Mass Index (BMI):
A standardised ratio of weight to height used as a general indicator of health. Your BMI can be calculated by dividing your weight (in kilograms) by the square of your height (in meters).

Fat Free Weight:
Fat-free mass, also known as lean body mass, refers to all of your body components except fat. It includes your body’s water, bone, organs, and muscle content.

Subcutaneous Fat:
As the name suggests subcutaneous fat is a fat located under the skin. The amount of subcutaneous fat you develop depends on genetics as well as lifestyle factors such as physical activity and diet. Subcutaneous fat is an important part of your body, but if your body is storing too much of it, you may be at a higher risk for health problems

Skeletal Muscle %:
A muscle which is connected to the skeleton to form part of the mechanical system which moves the limbs and other parts of the body. Skeletal muscle % is the ratio of your skeletal muscle mass to the total muscle mass multiplied by 100

Body Protein %:
Protein is an important component of every cell in the body. Hair and nails are mostly made of protein. Your body uses protein to build and repair tissues. You also use protein to make enzymes, hormones, and other body chemicals. Protein is an important building block of bones, muscles, cartilage, skin, and blood.

Health Score:

Your health score is calculated by assessment of all body parameters. The higher health score is an indication of good physical health.

Register here for Access token