Desi Calculator API Documentation

V1

/api/v1

First stable version for desi calculation requests.

GET /api/v1/desi/calculate Auth Required

Calculate Desi

Calculates desi with the formula (width x length x height) / 3000. All dimensions must be sent in centimeters.

Authentication

X-Api-Key: your_api_key

Query Parameters

Name	Type	Required	Example	Description
`width`	number	required	`40`	Package width in centimeters.
`length`	number	required	`30`	Package length in centimeters.
`height`	number	required	`20`	Package height in centimeters.

Request Example

GET /api/v1/desi/calculate?width=40&length=30&height=20

Response Example

{
    "success": true,
    "message": "Desi calculated successfully.",
    "data": {
        "width_cm": 40,
        "length_cm": 30,
        "height_cm": 20,
        "volume_cm3": 24000,
        "divisor": 3000,
        "unit": "cm",
        "formula": "desi = (width x length x height) / 3000",
        "desi": 8
    }
}

Error Response

{
    "success": false,
    "message": "The width field is required.",
    "error_code": "VALIDATION_ERROR"
}