通用异常分析

最后更新：2023年08月31日

接口能力

本接口可识别心电数据中的多种疑似心律异常，包括房性早搏、室性早搏、心动过速、心动过缓、停搏、漏搏、插入性室早、室性心动过速、二联律、三联律等，统计其发生次数和时间节点，可同时适用于动态或静态场景下所采集的数据。

警告

本接口分析结果仅供参考，请勿用于医疗诊断用途！

请求方法

HTTP方法： POST
请求URL：http://api.amsu-new.com/amsu-analysis/v2/arrhythmia/common/results/
数据提交方式：multipart/form-data

Header参数：

字段	类型	描述
Authorization	Bearer Token	构造方式为Bearer+(空格)+(Access Token)

Body参数：

字段	类型	必传	范围	描述
height	Integer	是	90 - 240	身高，单位：cm
weight	Float	是	30.0 - 200.9	体重，单位：kg
age	Integer	是	18 - 120	年龄
gender	Integer	是	0 - 1	性别，男1女0
ecg_file	File	是	*.ecg	二进制心电文件，以.ecg作后缀名，尺寸限制 100M 以内（约55小时离线数据）。数据将按照 小端序 2字节short型被解析，可使用 心电图查看工具 观察您的文件是否能正确解析
model	String	是	online、offline	心电记录模式，通过蓝牙采集的心电数据为online，在AMSU设备中存储的心电数据为offline
device	String	是	V6、S1	心电设备类型，对应蓝牙协议中「Device Information」-「Model Number」里包含的开发代号，心电衣（带）主机对应代号为V6，心电贴对应代号为S1

提示

若 model 为 online ，请在构造心电文件时用您自定义的信息（或任意值）填充前256个字节作为头部，若不构造头部，则文件中前1~2秒的心电数据不会参与分析。

返回参数

字段	类型	描述
id	Integer	本次分析的标识
hr	Integer	平均心率
beats_num	Integer	心搏次数
min_hr	Integer	最低心率
min_hr_time	Integer	最低心率对应的时间，单位：s
max_hr	Integer	最高心率
max_hr_time	Integer	最高心率对应的时间，单位：s
tachycardia	Integer	是否存在疑似心动过速，是1否0
bradycardia	Integer	是否存在疑似心动过缓，是1否0
apb	Integer	疑似房性早搏次数
pvc	Integer	疑似室性早搏次数
arrest	Integer	疑似停搏次数
missed	Integer	疑似漏搏次数
insert_pvc	Integer	疑似插入性室早次数
vt	Integer	疑似室性心动过速次数
bigeminy	Integer	疑似二联律次数
trigeminy	Integer	疑似三联律次数
apb_pos_list	Array of Integer	疑似房早的发生时间（秒）列表
pvc_pos_list	Array of Integer	疑似室早的发生时间（秒）列表
arrest_pos_list	Array of Integer	疑似停搏的发生时间（秒）列表
missed_pos_list	Array of Integer	疑似漏搏的发生时间（秒）列表
insert_pvc_pos_list	Array of Integer	疑似插入性室早的发生时间（秒）列表
vt_pos_list	Array of Integer	疑似室性心动过速的发生时间（秒）列表
bigeminy_pos_list	Array of Integer	疑似二联律的发生时间（秒）列表
trigeminy_pos_list	Array of Integer	疑似三联律的发生时间（秒）列表

正确返回示例：

HTTP状态码：200

{
    "id": 72048,
    "hr": 76,
    "beats_num": 3774,
    "min_hr": 59,
    "min_hr_time": 1857,
    "max_hr": 108,
    "max_hr_time": 1748,
    "tachycardia": 0,
    "bradycardia": 0,
    "apb": 1,
    "pvc": 0,
    "arrest": 0,
    "missed": 0,
    "insert_pvc": 0,
    "vt": 0,
    "bigeminy": 0,
    "trigeminy": 0,
    "apb_pos_list": [
        405
    ],
    "pvc_pos_list": [],
    "arrest_pos_list": [],
    "missed_pos_list": [],
    "insert_pvc_pos_list": [],
    "vt_pos_list": [],
    "bigeminy_pos_list": [],
    "trigeminy_pos_list": []
}

错误返回示例：

HTTP状态码不为200

{
    "error": {
        "code": "ECG.INVALID_DATA",
        "msg": "ECG data cannot be analyzed normally, which may be due to wrong format or poor signal quality."
    }
}

错误码

HTTP状态码	错误码	说明
422	ECG.INVALID_DATA	无法从心电数据中有效识别出R波，此错误的可能原因有：1. 心电文件格式出错；2.心电数据未正常采集；3.心电数据质量过差

另请参见 公共错误码

示例代码

JavaObjective-CJavaScriptPython

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("height","188")
  .addFormDataPart("weight","88.8")
  .addFormDataPart("gender","0")
  .addFormDataPart("age","18")
  .addFormDataPart("ecg_file","example_online.ecg",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("/datas/example_online.ecg")))
  .addFormDataPart("model","online")
  .addFormDataPart("device","V6")
  .build();
Request request = new Request.Builder()
  .url("http://api.amsu-new.com/amsu-analysis/v2/arrhythmia/common/results/")
  .method("POST", body)
  .addHeader("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJhcHBfa2V5OjkzZWUyMGNiNTliOTY0OWY3YzIwIiwiZXhwIjoxNjQ4Njk5MjA2fQ.WljGB-66JR9CFNYzaXjR81i0ySNmXfVAsqVW_lfLT7g")
  .build();
Response response = client.newCall(request).execute();

#import <Foundation/Foundation.h>

dispatch_semaphore_t sema = dispatch_semaphore_create(0);

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"http://api.amsu-new.com/amsu-analysis/v2/arrhythmia/common/results/"]
  cachePolicy:NSURLRequestUseProtocolCachePolicy
  timeoutInterval:10.0];
NSDictionary *headers = @{
  @"Authorization": @"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJhcHBfa2V5OjkzZWUyMGNiNTliOTY0OWY3YzIwIiwiZXhwIjoxNjQ4Njk5MjA2fQ.WljGB-66JR9CFNYzaXjR81i0ySNmXfVAsqVW_lfLT7g"
};

[request setAllHTTPHeaderFields:headers];
NSArray *parameters = @[
  @{ @"name": @"height", @"value": @"188" }, 
  @{ @"name": @"weight", @"value": @"88.8" }, 
  @{ @"name": @"gender", @"value": @"0" }, 
  @{ @"name": @"age", @"value": @"18" }, 
  @{ @"name": @"ecg_file", @"fileName": @"/datas/example_online.ecg" }, 
  @{ @"name": @"model", @"value": @"online" }, 
  @{ @"name": @"device", @"value": @"V6" } 
];

NSString *boundary = @"----WebKitFormBoundary7MA4YWxkTrZu0gW";
NSError *error;
NSMutableString *body = [NSMutableString string];

for (NSDictionary *param in parameters) {
  [body appendFormat:@"--%@\r\n", boundary];
  if (param[@"fileName"]) {
    [body appendFormat:@"Content-Disposition:form-data; name=\"%@\"; filename=\"%@\"\r\n", param[@"name"], param[@"fileName"]];
    [body appendFormat:@"Content-Type: %@\r\n\r\n", param[@"contentType"]];
    [body appendFormat:@"%@", [NSString stringWithContentsOfFile:param[@"fileName"] encoding:NSUTF8StringEncoding error:&error]];
    if (error) {
      NSLog(@"%@", error);
    }
  } else {
    [body appendFormat:@"Content-Disposition:form-data; name=\"%@\"\r\n\r\n", param[@"name"]];
    [body appendFormat:@"%@", param[@"value"]];
  }
}
[body appendFormat:@"\r\n--%@--\r\n", boundary];
NSData *postData = [body dataUsingEncoding:NSUTF8StringEncoding];
[request setHTTPBody:postData];

[request setHTTPMethod:@"POST"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
    dispatch_semaphore_signal(sema);
  } else {
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
    NSError *parseError = nil;
    NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
    NSLog(@"%@",responseDictionary);
    dispatch_semaphore_signal(sema);
  }
}];
[dataTask resume];
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJhcHBfa2V5OjkzZWUyMGNiNTliOTY0OWY3YzIwIiwiZXhwIjoxNjQ4Njk5MjA2fQ.WljGB-66JR9CFNYzaXjR81i0ySNmXfVAsqVW_lfLT7g");

var formdata = new FormData();
formdata.append("height", "188");
formdata.append("weight", "88.8");
formdata.append("gender", "0");
formdata.append("age", "18");
formdata.append("ecg_file", fileInput.files[0], "example_online.ecg");
formdata.append("model", "online");
formdata.append("device", "V6");

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: formdata,
  redirect: 'follow'
};

fetch("http://api.amsu-new.com/amsu-analysis/v2/arrhythmia/common/results/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests

url = "http://api.amsu-new.com/amsu-analysis/v2/arrhythmia/common/results/"

payload={'height': '188',
'weight': '88.8',
'gender': '0',
'age': '18',
'model': 'online',
'device': 'V6'}

files=[
  ('ecg_file',('example_online.ecg',open('/datas/example_online.ecg','rb'),'application/octet-stream'))
]
headers = {
  'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJhcHBfa2V5OjkzZWUyMGNiNTliOTY0OWY3YzIwIiwiZXhwIjoxNjQ4Njk5MjA2fQ.WljGB-66JR9CFNYzaXjR81i0ySNmXfVAsqVW_lfLT7g'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)