首页 开发文档 BMI 计算

BMI 计算

BMI 体质指数计算。按 BMI = 体重(kg) ÷ 身高(m)² 计算,分级采用中国成人标准(WS/T 428-2013):低于 18.5 偏瘦、18.5-23.9 正常、24-27.9 超重、28 及以上肥胖,这与国际通用标准不同,更符合中国人群的体型特征。同时给出该身高对应的标准体重区间、理想体重与针对性健康建议。

请求信息
请求地址 https://cx4.cn/openApi/life/bmi 复制
请求方式 GET / POST
接口标识 life_bmi
鉴权方式 必须
四种方式任选其一:Header「X-Api-Key」/ Header「Authorization: Bearer 你的key」/ URL 参数「?key=你的key」/ POST 参数「key」
请求参数
参数名 类型 必填 说明 示例
height float 是 身高,单位 cm,范围 50-250 175
weight float 是 体重,单位 kg,范围 2-500 70
返回参数

下表字段位于返回结构的 data 内;外层 code / message 为全平台统一格式,不在此重复列出。

参数名 类型 说明 示例
ok bool 是否成功 true
height float 身高 cm 175
weight float 体重 kg 70
bmi float BMI 指数 22.86
level string 分级结论 正常
advice string 健康建议 保持当前体重
standard_min float 标准体重下限 kg 56.7
standard_max float 标准体重上限 kg 73.9
ideal_weight float 理想体重 kg 65.6
healthy_range string 健康体重区间 56.7 ~ 73.9 kg
返回示例

成功

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "ok": true,
        "height": 175,
        "weight": 70,
        "bmi": 22.86,
        "level": "正常",
        "advice": "保持当前饮食与运动习惯即可",
        "standard_min": 56.7,
        "standard_max": 73.2,
        "ideal_weight": 67.4,
        "healthy_range": "18.5 ~ 23.9(中国成人标准)"
    }
}

失败

{
    "code": 400,
    "message": "身高和体重都必须大于 0",
    "data": null
}
平台通用状态码
状态码 说明
200调用成功
400缺少必填参数或参数格式有误
401密钥缺失或无效
402余额不足,请充值后重试
403未开通该接口,请在本页开通后调用
404接口不存在或已下架
429触发限流,请稍后重试
500接口调用失败(已扣款的会自动退款)
调用示例

cURL 复制

curl -X POST "https://cx4.cn/openApi/life/bmi" -H "X-Api-Key: 你的SecretKey" -d "height=175&weight=70"

JavaScript 复制

fetch('https://cx4.cn/openApi/life/bmi', {
  method: 'POST',
  headers: {
    'X-Api-Key': '你的SecretKey',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: 'height=175&weight=70'
})
.then(res => res.json())
.then(data => console.log(data));

PHP 复制

post('https://cx4.cn/openApi/life/bmi', [
    'headers' => ['X-Api-Key' => '你的SecretKey'],
    'form_params' => ['height' => '175', 'weight' => '70'],
]);
echo $response->getBody();

Java 复制

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://cx4.cn/openApi/life/bmi"))
    .header("X-Api-Key", "你的SecretKey")
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString("height=175&weight=70"))
    .build();
HttpResponse response = client.send(
        request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Python 复制

import requests

res = requests.post('https://cx4.cn/openApi/life/bmi',
    headers={'X-Api-Key': '你的SecretKey'},
    data={'height': '175', 'weight': '70'})
print(res.json())
在线测试 (使用你的密钥真实调用,计费与正常调用一致)

登录后可在线测试: 立即登录

计费说明

¥0.0010

每次调用


每日免费额度:100 次

累计调用:3 次


快速上手

1. 注册并完成邮箱验证:立即注册

2. 登录后复制 Secret Key:去登录

3. 点击右侧「开通接口」按钮

4. 用下方「在线测试」一键体验,或复制下方示例代码直接调用