计费概述
经穴智能检测API提供预付费计费模式。
产品价格
免费试用
首次开通服务的用户，可以申请一次免费试用服务，开通服务后即可在开放平台的个人资料查看，免费资源包有效期为90天，90天内若资源包次数未使用完且未购买预付费资源包，则过期作废。若已购买预付费资源包且超额调用，则超额部分转为预付费，若未购买预付费资源包或预付费资源包用完，则停止服务。
预付费
预付费资源包不支持购买后退费。具体预付费资源包套餐价格参见购买详情页。
计费与抵扣方式
计费方式
经穴智能检测API的测试包按时间和调用量组合计费，如果在可用时间内将调用量使用完，需要购买调用次数包。
调用次数包，含有资源可调用次数，支持同时购买多个，购买后的资源包配额次数可叠加，且同时启用生效。
抵扣方式
抵扣顺序为：免费资源包 > 预付费资源包。
退款说明
经穴智能检测API提供预付费计费模式，暂不支持退款。
资源通知
用户在购买资源成功后，我们针对以下情况会通过站内信及短信的方式通知到用户，具体如下表所示：
购买成功通知
用户在购买资源包成功后，会收到购买资源包成功通知。
调用量预警通知
当您的资源包用量不足总量的10%时，会收到资源包剩余量预警通知。
调用量耗尽通知
当您的资源包用量为总量的0%时，会提醒用户资源包调用量已用完，资源包用完后即停止服务。
API文档
术语和定义
失败请求：经穴API将错误码为“内部错误”的请求和因为经穴API故障导致的用户正常请求未能到达经穴API服务器端的请求视为失败请求，但不包括以下类型的请求：
因采用不适当的访问模式导致请求超出经穴API的 QPS（每秒钟请求数量），造成经穴API失败的请求（错误码为：内部错误)。
您的应用程序受到黑客攻击而导致经穴API失败的请求（错误码为：内部错误)。
有效请求：经穴API服务器端收到的请求视为有效请求，但不包括以下类型的请求：
未开通/授权服务和鉴权失败的请求、欠费请求、密钥错误请求。
在符合流程和手续完备的情况下，可以提供相关信息，包括关键组件的运行日志、运维人员的操作记录、客户操作记录等信息。
业务接口展示-查询原穴穴位
说明：返回系统内置的原穴穴位列表（id/name/中文名/拼音/国标代码/器官/x/y 坐标等），用于前端加载原穴图谱与选穴界面。
请求地址: /api/meridianscan/getOriginalAcupoint
请求参数
本接口为查询类接口，无需业务参数，公共参数 secretId/timestamp/sign 必传（请求体为空）。
JSON 请求示例
POST https://api.miaolangzhong.com/api/meridianscan/getOriginalAcupoint
响应参数
code
Integer
响应状态码。0-失败，1-成功。
message
String
中文提示信息。code=1 时 message="成功"。
data
Array
原穴穴位数组，每项含 id/num/name/enName/location/internationalCode/img/x/y/organ/pinyin/zhuzhi/area/qushi/chaoxiang/gender 等字段。
JSON 响应示例
{
"code": 1,
"message": "成功",
"data": [
{
"id": 1,
"num": 1,
"num1": 0,
"num2": 0,
"num3": 0,
"name": "太渊",
"enName": "Taiyuan",
"location": "腕掌侧横纹桡侧，桡动脉搏动处。",
"internationalCode": "LU9",
"img": "https://example.com/acupoint/taiyuan.png",
"x": 120,
"y": 240,
"organ": "肺",
"pinyin": "taiyuan",
"zhuzhi": "肺经原穴",
"area": 0,
"qushi": "五输穴",
"chaoxiang": 0,
"gender": 0
}
],
"ok": true
}
业务接口展示-查询腧穴穴位
说明：返回系统内置的腧穴穴位列表（与查询原穴穴位同结构），用于前端加载腧穴图谱与选穴界面。
请求地址: /api/meridianscan/getAcupoint
请求参数
本接口为查询类接口，无需业务参数，公共参数 secretId/timestamp/sign 必传（请求体为空）。
JSON 请求示例
POST https://api.miaolangzhong.com/api/meridianscan/getAcupoint
响应参数
响应结构与"查询原穴穴位"一致：code/message/data[]/ok。其中 data[] 每项含 id/num/name/enName/location/internationalCode/img/x/y/organ/pinyin/zhuzhi/area/qushi/chaoxiang/gender。
JSON 响应示例
{
"code": 1,
"message": "成功",
"data": [
{
"id": 12,
"num": 12,
"name": "合谷",
"enName": "Hegu",
"location": "手背，第1、2掌骨间，当第二掌骨桡侧的中点处。",
"internationalCode": "LI4",
"img": "https://example.com/acupoint/hegu.png",
"x": 200,
"y": 300,
"organ": "大肠",
"pinyin": "hegu",
"zhuzhi": "大肠经原穴",
"area": 0,
"qushi": "原穴",
"chaoxiang": 0,
"gender": 0
}
],
"ok": true
}
业务接口展示-保存检测用户信息
说明：用于建立或更新一名经穴检测的被检测人档案，返回检测记录 id（供后续 saveScanResult/updateOutpatientInfo/getRecordDetail 等接口联动使用）。
请求地址: /api/meridianscan/saveUserInfo
请求参数
imgUrl
String
否
耳像图片 JSON：{"left_img":"...","right_img":"..."}（非必填）。
gender
Integer
否
性别：0-女，1-男。
bp
String
否
血压：0-正常，1-高，2-低。
type
String
否
定标方式：1-自动定标，2-使用定标值，3-选择定标穴。
dingbiaovalue
String
否
使用选择定标穴时传，每个定标穴的检测值（JSON 字符串）。
JSON 请求示例
POST https://api.miaolangzhong.com/api/meridianscan/saveUserInfo
{
"phone": "13800138000",
"imgUrl": "{\"left_img\":\"https://example.com/ear/left.jpg\",\"right_img\":\"https://example.com/ear/right.jpg\"}",
"age": "30",
"gender": 1,
"name": "张三",
"icard": "110101199001011234",
"bp": "0",
"type": "1",
"avg": "",
"dingbiaovalue": ""
}
响应参数
code
String
响应状态码。1-成功，其他见业务错误码。
data.id
String
本次创建的检测记录 id，后续所有接口都需使用该 id。
JSON 响应示例
{
"code": "1",
"message": "成功",
"data": {
"id": "2025112014300001"
}
}
业务接口展示-保存经络检测结果
说明：把全部穴位的检测值（id/name/val）一次性提交给平台，平台返回经络检测结果与初步健康风险建议。
请求地址: /api/meridianscan/saveScanResult
请求参数
id
String
否
检测记录 id（saveUserInfo 返回的 id）。
acupointValue
String
否
全部穴位检测值 JSON 字符串，格式：[{"id":"1","name":"耳尖","val":"921"}...]。
JSON 请求示例
POST https://api.miaolangzhong.com/api/meridianscan/saveScanResult
{
"id": "2025112014300001",
"acupointValue": "[{\"id\":\"1\",\"name\":\"耳尖\",\"val\":\"921\"},{\"id\":\"2\",\"name\":\"风溪\",\"val\":\"836\"}]"
}
响应参数
接口成功时返回 200 OK，详细返回结构以实际接口响应为准（包含经络分析结果、健康风险建议等）。
业务接口展示-更新门诊号和住院号
说明：给已生成的检测记录补填门诊号、住院号。参数通过 POST 请求体（JSON）提交。
请求地址: /api/meridianscan/updateOutpatientInfo
请求参数
id
String
否
检测记录 id（POST body 传参）。
JSON 请求示例
POST https://api.miaolangzhong.com/api/meridianscan/updateOutpatientInfo
{
"id": "2025112014300001",
"outpatientNum": "MZ-0001",
"admissionNum": "ZY-0001"
}
响应参数
接口成功时返回 200 OK，无业务返回数据。
业务接口展示-获取经络检测报告详情
说明：传入检测记录 id，返回该次经络检测的完整报告（被检测人信息、检测值、经络分析、健康建议等）。
请求地址: /api/meridianscan/getRecordDetail
请求参数
JSON 请求示例
POST https://api.miaolangzhong.com/api/meridianscan/getRecordDetail
{
"id": "2025112014300001"
}
响应参数
接口成功时返回 200 OK，详细返回结构以实际接口响应为准（包含被检测人信息、各经络检测值、结论、建议等）。
业务接口展示-查询检测记录
说明：分页查询当前用户的经穴检测记录，可按姓名/手机号/起止日期过滤。
请求地址: /api/meridianscan/getRecordList
请求参数
startTime
String
否
开始日期（yyyy-MM-dd）。
endTime
String
否
结束日期（yyyy-MM-dd）。
JSON 请求示例
POST https://api.miaolangzhong.com/api/meridianscan/getRecordList
{
"size": "20",
"page": "1",
"name": "张三",
"phone": "13800138000",
"startTime": "2025-01-01",
"endTime": "2025-12-31"
}
响应参数
接口成功时返回 200 OK，详细返回结构以实际接口响应为准（每条记录包含姓名/手机号/年龄/性别/检测结果/创建时间等）。
登录
返回
