附录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计算方法