Prototech 3D Measure Up API

ProtoTech 3D Measure Up API is a service that makes it easy to identify various features (landmarks) and measure 3D body. Our anthropometric landmarks are as per ISO 8559-1, but we provide much more.


Request Syntax

Request Syntax


Request Parameters

The request accepts the following data in JSON format


url

The url is the source path of the 3D scan of a human body.
Type: String
Pattern: Valid http url
Required: Yes
Example: https://google-drive.com/ASDJKAHSLDALKSLKASMDNSLASDNNAS


source

The source indicates the type of the source url. Whether it is a google drive path or just another http url.
Type: Number
Values:
1: For Google drive
2: For any other http url
Required: Yes


Response Syntax

Response Syntax measure up doc


Response Elements

If the action is sucessful, the service sends back an HTTP 200 response. 

The following data is returned in JSON format by the service

Metrics 

 A composition of Girths, Heights, Landmarks, Levels, Lengths, Lines, Surface Lengths extracted by the algorithm.

Each metric has a confidence value between 0 and 100 that indicates the percentage confidence that 3D measureup has that the landmark has been detected and that the measurement is correct. The confidence level is affected  by factors such as quality of the scan.


Errors

AccessDeniedException

You are not authorized to perform the action.

HTTP Status Code: 403

InternalServerError

3DMU service  experienced a service issue. Try your call again.

HTTP Status Code: 500

ProvisionedThroughputExceededException

The number of requests exceeded your throughput limit. If you want to increase this limit.

HTTP Status Code: 400

ThrottlingException

3DMU is temporarily unable to process the request. Try your call again.

HTTP Status Code: 500

Usage

NOTE: Before you use this API, please make sure you replace with the API key provided to you separately. If it is not, please contact info@prototechsolutions.com for your API key.

CURL

  1. Create/ Download json.txt file.

Contents of json.txt file:

     {
	"url": "",
	"source": 2
     }

Note:
1: For Google drive
2: For any other http url


     curl -X POST -H "Content-Type: application/json" -d @json.txt --header "x-api-key: "https://3dmu-api.prototechsolutions.com/dev/measurements/default --insecure

Response Syntax


{
    "results": {
        "metrics": {
            "girths": [
                {
                    "id": 101,
                    "name": "head_start",
                    "label": "Head Start",
                    "girth": [],
                    "level": 23.20072364807129,
                    "confidence": 0
                },
                {
                    "id": 102,
                    "name": "head_end",
                    "label": "Head End",
                    "girth": [],
                    "level": 20.187228054870605,
                    "confidence": 0
                },
               {
                    "id": 103,
               {
                    "id": 103,
                    "name": "neck_end",
                    "label": "Neck End",
                    "girth": [],
                    "level": 19.433854156570433,
                    "confidence": 0
                },
                {
                    "id": 104,
                    "name": "shoulder",
                    "label": "Shoulder",
                    "girth": [],
                    "level": 18.680480258270265,
                    "confidence": 0
                },
                {
                    "id": 126,
                    "name": "right_biceps_girth",
                    "label": "Right Biceps",
                    "girth": [
                        3.75
                    ],
                    "level": 17.876088351050928,
                    "confidence": 90
                },
                {
                    "id": 125,
                    "name": "left_biceps_girth",
                    "label": "Left Biceps",
                    "girth": [],
                    "level": 16.33790519426816,
                    "confidence": 0
                },
                {
                    "id": 105,
                    "name": "chest",
                    "label": "Chest",
                    "girth": [
                        4.71
                    ],
                    "level": 17.17373246166992,
                    "confidence": 90
                },
                {
                    "id": 106,
                    "name": "chest_end",
                    "label": "Chest End",
                    "girth": [
                        4.98
                    ],
                    "level": 16.42035856336975,
                    "confidence": 90
                },
                {
                    "id": 107,
                    "name": "belly",
                    "label": "Belly",
                    "girth": [],
                    "level": 14.160236868469237,
                    "confidence": 0
                },
                {
                    "id": 108,
                    "name": "waist",
                    "label": "Waist",
                    "girth": [],
                    "level": 12.653489071868897,
                    "confidence": 0
                },
                {
                    "id": 109,
                    "name": "butt",
                    "label": "Butt",
                    "girth": [],
                    "level": 11.900115173568725,
                    "confidence": 0
                },
               {
                    "id": 110,
                    "name": "crotch",
                    "label": "Crotch",
                    "girth": [],
                    "level": 11.146741275268555,
                    "confidence": 0
                },
                {
                    "id": 112,
                    "name": "right_mid_thigh",
                    "label": "Right Mid Thigh",
                    "girth": [
                        6.54
                    ],
                    "level": 8.886619580368041,
                    "confidence": 90
                },
                {
                    "id": 111,
                    "name": "left_mid_thigh",
                    "label": "Left Mid Thigh",
                    "girth": [
                        7.34
                    ],
                    "level": 8.886619580368041,
                    "confidence": 90
                },
                {
                    "id": 113,
                    "name": "right_knee",
                    "label": "Right Knee",
                    "girth": [
                        5.66
                    ],
                    "level": 6.62649788546753,
                    "confidence": 90
                },
                {
                    "id": 114,
                    "name": "left_knee",
                    "label": "Left Knee",
                    "girth": [
                        5.6
                    ],
                    "level": 6.62649788546753,
                    "confidence": 90
                },
                {
                    "id": 116,
                    "name": "right_mid_calf",
                    "label": "Right Mid Calf",
                    "girth": [
                        7.9
                    ],
                    "level": 3.613002292266847,
                    "confidence": 90
                },
                {
                    "id": 115,
                    "name": "left_mid_calf",
                    "label": "Left Mid Calf",
                    "girth": [],
                    "level": 3.613002292266847,
                    "confidence": 0
                },
                {
                    "id": 118,
                    "name": "right_ankle",
                    "label": "Right Ankle",
                    "girth": [
                        3.89
                    ],
                    "level": 1.352880597366335,
                    "confidence": 90
                },
                {
                    "id": 117,
                    "name": "left_ankle",
                    "label": "Left Ankle",
                    "girth": [],
                    "level": 1.352880597366335,
                    "confidence": 0
                },
                {
                    "id": 119,
                    "name": "right_foot_end",
                    "label": "Right Foot End",
                    "girth": [],
                    "level": 0,
                    "confidence": 0
                },
                {
                    "id": 120,
                    "name": "left_foot_end",
                    "label": "Left Foot End",
                    "girth": [],
                    "level": 0,
                    "confidence": 0
                }
            ]
        }
    }
}
                

Contact Us

Contact Us
reCAPTCHA