附录1:错误码说明
以下列表为鹰眼错误码,为鹰眼 Android SDK、iOS SDK、Web 服务 API 所公用。除鹰眼错误码外,其他通用控制服务错误码请见通用控制服务错误码定义。
status 状态码 | message 描述信息 | 注释 |
---|---|---|
0 | 成功 | 请求成功 |
1 | 服务器内部错误 | 该服务响应超时或系统内部错误 |
2 | 参数错误 | 具体错误信息将在 message 中给出 |
3 | http method错误 | 检查请求的 http method(GET/POST)是否与接口描述一致 |
3003 | 指定 entity 不存在 | 未查询到 entity_name 为设定值的 entity,请检查 entity_name 是否输入错误或已被删除 |
3005 | entity_name已存在 | entity_name 是 entity 的唯一标识,在同一 service 中不可创建 entity_name 重复的 entity,请更换名字后再次尝试 |
3006 | 查询时间段内的轨迹点过多,无法进行纠偏,请缩短查询时间 | entity_name不符合命名规范:仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字。 |
3007 | 数据解析失败,数据中包含非utf8编码字符 | 返回的字段值中存在非 utf8编码的字符。所有上传的字符均应以 utf8 编码 |
4005 | 指定service_id不存在 | 请求参数中service_id填写错误或不属于当前账号,请检查是否填写了正确的service_id |
5101 | 监控对象的围栏个数超出范围,最多100个 | 一个监控对象最多可创建100个围栏,建议定期清理无效围栏 |
5102 | 监控对象不存在 | 创建或更新围栏时,指定的监控对象 entity_name 不存在 |
5103 | 监控对象上没有fence_id为XXX的围栏 | |
5104 | 指定fence_id不存在 | |
9001 | 查询时间段内的轨迹点过多,无法进行轨迹分析,请缩短查询时间 | 一次请求查询的轨迹点不可超过两万,否则将返回失败 |
附录2:编码说明
API请求中需要用到中文或一些特殊字符的参数,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
字符集合 | 字符 |
---|---|
URL非保留字 | a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
URL保留字 | ! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
如果中文参数中使用URL保留字字符的字面意思,例如,检索关键字包含一个问号,此问号也必须进行编码。附注:
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。附录3:sn计算算法
详见SN计算方法