名称	参数	必填	说明
开发者ID	id	是	用户中心的数字ID，例：id=10000000
开发者KEY	key	是	用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2
待转换单位	unit	是	待转换单位，传中文，支持：米，千米，分米，厘米，毫米，微米，纳米，里，丈，尺，寸，英里，码，英尺，英寸，海里。例：unit=米
待转换数值	num	是	待转换数值，例：num=1024
动态秘钥	dkey	否	开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371
用户IP	uip	否	接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。

返回参数说明

名称	参数	说明
状态码	code	200成功，400错误
提示信息	msg	信息提示。
转换前数值	num	转换前数值。
转换前单位	unit	转换前单位。
转换后数据集	data	转换后数据集。
转换后数值	data.num	转换后数值。
转换后单位	data.unit	转换后单位。
转换后名称	data.name	转换后中文名称。
支持单位数据集	units	当请求参数为无效单位名称时返回。

返回数据示例

示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
    "code": 200,
    "num": "1000",
    "unit": "米",
    "data": [{
        "num": "1000",
        "unit": "m",
        "name": "米"
    }, {
        "num": "1",
        "unit": "km",
        "name": "千米"
    }, {
        "num": "10000",
        "unit": "dm",
        "name": "分米"
    }, {
        "num": "100000",
        "unit": "cm",
        "name": "厘米"
    }, {
        "num": "1000000",
        "unit": "mm",
        "name": "毫米"
    }, {
        "num": "1000000000",
        "unit": "μm",
        "name": "微米"
    }, {
        "num": "1000000000000",
        "unit": "nm",
        "name": "纳米"
    }, {
        "num": "2",
        "unit": "",
        "name": "里"
    }, {
        "num": "300",
        "unit": "",
        "name": "丈"
    }, {
        "num": "3000",
        "unit": "",
        "name": "尺"
    }, {
        "num": "30000",
        "unit": "",
        "name": "寸"
    }, {
        "num": "0.62137119223733396961",
        "unit": "mile",
        "name": "英里"
    }, {
        "num": "1093.61329833770778652668",
        "unit": "yd",
        "name": "码"
    }, {
        "num": "3280.83989501312335958005",
        "unit": "ft",
        "name": "英尺"
    }, {
        "num": "39370.07874015748031496062",
        "unit": "in",
        "name": "英寸"
    }, {
        "num": "0.53995680345572354211",
        "unit": "nmi",
        "name": "海里"
    }]
}
示例：
{
    "code": 400,
    "message": "无效的单位类型",
    "units": [
        "米",
        "千米",
        "分米",
        "厘米",
        "毫米",
        "微米",
        "纳米",
        "里",
        "丈",
        "尺",
        "寸",
        "英里",
        "码",
        "英尺",
        "英寸",
        "海里"]
}

更新记录

2026-05-09 20:52:47 - 新增接口。

单位换算-长度单位换算-2026-05-09 21:22:52

长度单位换算。支持：米，千米，分米，厘米，毫米，微米，纳米，里，丈，尺，寸，英里，码，英尺，英寸，海里。

调用限制

调用权限	非定制接口直接使用
单价/次	免费[无上限]
单日[所有用户之和]	999999999
1分钟并发[所有用户之和]	999999999
1小时并发[所有用户之和]	999999999
频次限制[注册用户]	10次/分钟\|每日无上限
频次限制[钻石会员]	最高8000+次/分钟\|每日无上限
频次限制[定制频次]	联系我们定制

调用方法

请求方式	GET/POST
返回格式	JSON
编码格式	UTF-8

调用信息

浏览量	43
今日总计调用	1
昨日总计调用	0
历史总计调用	73
今日排名	300
总排名	437

自检信息

自检启用状态	未开启
自检节点	/
自检线路	彩钻接口线路
自检时间	/
自检耗时	/ 毫秒
自检状态	/
历史自检成功数	/ 次
历史自检失败数	/ 次
历史自检成功率	/ %
今日自检成功数	/ 次
今日自检失败数	/ 次
今日自检成功率	/ %