开放接口使用说明

接口调用顺序

第一步：先通向我司相销售人员申请 API权限，获取到授权的信息参数。

第二步：通过Authentication接口获取到对应的token鉴权信息。

第三步：通过UserInfo接口获取平台创建的用户信息。

第四步：通过DeviceInfo接口获取用户对应的设备列表，拿到设备相关的信息。

第四步：通过得到的用户信息或设备信息作为参数获取其它接口数据。

测试参数：CheckID=1 Key=1E9F60A38D4184E921F9BF21827991AF

测试账号：test688 测试密码：123456

说明

此接口为中科信通提供给需要二次开发的客户的数据支撑接口，如需使用请联系相关人员开放权限。如有其他本接口暂未提供数据使用需求，可联系相关人员咨询。

Alarm

设备报警信息相关接口

API	接口说明
POST api/Alarm/PostWarnList	获取设备报警列表接口
GET api/Alarm/GetWarnList/{ID}?PageNo={PageNo}&PageCount={PageCount}&TypeID={TypeID}&TimeZone={TimeZone}&MapType={MapType}&StartTime={StartTime}&EndTime={EndTime}&Token={Token}&Language={Language}	获取设备报警列表接口
POST api/Alarm/PostUntreatedWarnList	获取单个设备某种类型未被处理的报警列表接口
GET api/Alarm/GetUntreatedWarnList?DeviceID={DeviceID}&AlarmType={AlarmType}&TimeZone={TimeZone}&MapType={MapType}&Token={Token}&Language={Language}	获取单个设备某种类型未被处理的报警列表接口
POST api/Alarm/PostClearAlarm	清除某条报警信息
GET api/Alarm/GetClearAlarm?ExceptionID={ExceptionID}&Token={Token}&Language={Language}	清除某条报警信息
POST api/Alarm/PostOneDeviceWarnAll	获取单个设备的所有报警接口
GET api/Alarm/PutOneDeviceWarnAll?DeviceID={DeviceID}&MapType={MapType}&TimeZone={TimeZone}&Token={Token}&Language={Language}	获取单个设备的所有报警接口

Authentication

鉴权相关接口

API	接口说明
POST api/Authentication/PostToken	获取token信息
GET api/Authentication/GetToken?CheckID={CheckID}&Key={Key}&Token={Token}&Language={Language}	获取token信息

Cmd

设备指令相关接口

API	接口说明
POST api/Cmd/PostCmdList	获取设备某个型号支持的指令列表 ***主要用于首次集成接口时根据自己使用的设备型号获取对应型号支持的指令，接口文档中非自己型号的指令可以不用集成，如果没有需求的指令集，请联系相关人员申请添加。也可以联系相关人员获取指令相关的.doc文档版本。
GET api/Cmd/GetCmdList?Model={Model}&Token={Token}&Language={Language}	获取设备某个型号支持的指令列表 ***主要用于首次集成接口时根据自己使用的设备型号获取对应型号支持的指令，接口文档中非自己型号的指令可以不用集成，如果没有需求的指令集，请联系相关人员申请添加
POST api/Cmd/PostSendCmd	发送某个指令给设备
GET api/Cmd/GetSendCmd?DeviceID={DeviceID}&CmdType={CmdType}&CmdValue={CmdValue}&Token={Token}&Language={Language}	发送某个指令给设备
POST api/Cmd/PostSendCmdHistory	查询某个设备设置指令记录
GET api/Cmd/GetSendCmdHistory?DeviceID={DeviceID}&PageNo={PageNo}&PageCount={PageCount}&TimeZone={TimeZone}&Token={Token}&Language={Language}	查询某个设备设置指令记录

DeviceInfo

设备信息相关接口

API	接口说明
POST api/DeviceInfo/PostDeviceList	获取当前用户名下的设备列表接口(分页)
GET api/DeviceInfo/GetDeviceList/{ID}?PageNo={PageNo}&PageCount={PageCount}&TypeID={TypeID}&MapType={MapType}&Token={Token}&Language={Language}	获取当前用户名下的设备列表接口(分页)
POST api/DeviceInfo/PostDeviceListAll	获取当前用户名下的设备列表接口(不分页)
GET api/DeviceInfo/GetDeviceListAll/{ID}?TypeID={TypeID}&MapType={MapType}&TimeZone={TimeZone}&Token={Token}&Language={Language}	获取当前用户名下的设备列表接口(不分页)
POST api/DeviceInfo/PostDeviceListAllChildren	获取当前用户及其所有下级用户名下的设备列表接口(不分页)
GET api/DeviceInfo/GetDeviceListAllChildren?UserID={UserID}&MapType={MapType}&TimeZone={TimeZone}&Token={Token}&Language={Language}	获取当前用户及其所有下级用户名下的设备列表接口(不分页)
POST api/DeviceInfo/PostGroupInfo	获取当前用户创建的分组信息
GET api/DeviceInfo/GetGroupInfo?UserID={UserID}&Token={Token}&Language={Language}	获取当前用户创建的分组信息
POST api/DeviceInfo/PostDelGroupInfo	删除分组信息
GET api/DeviceInfo/GetDelGroupInfo?UserID={UserID}&GroupID={GroupID}&Token={Token}&Language={Language}	删除分组信息
POST api/DeviceInfo/PostAddGroupInfo	新增或编辑分组信息
GET api/DeviceInfo/GetAddGroupInfo?GroupID={GroupID}&GroupName={GroupName}&UserID={UserID}&Token={Token}&Language={Language}	新增或编辑分组信息
POST api/DeviceInfo/PostRemoveGroupInfo	设备转移分组接口信息
GET api/DeviceInfo/GetRemoveGroupInfo?DeviceID={DeviceID}&GroupID={GroupID}&Token={Token}&Language={Language}	设备转移分组接口信息
POST api/DeviceInfo/PostUpdateDeviceName	修改指定设备的设备名称
GET api/DeviceInfo/GetUpdateDeviceName?DeviceID={DeviceID}&DeviceName={DeviceName}&Token={Token}&Language={Language}	修改指定设备的设备名称
POST api/DeviceInfo/PostOBDInfo	获取某个设备的OBD信息
GET api/DeviceInfo/GetOBDInfo?DeviceID={DeviceID}&TimeZone={TimeZone}&Token={Token}&Language={Language}	获取某个设备的OBD信息
POST api/DeviceInfo/PostUpdateImportant	更新设备是否被关注信息
GET api/DeviceInfo/GetUpdateImportant?DeviceID={DeviceID}&IsImportant={IsImportant}&Token={Token}&Language={Language}	更新设备是否被关注信息
POST api/DeviceInfo/PostOneDeviceInfo	获取某个设备的详细信息
GET api/DeviceInfo/GetOneDeviceInfo?DeviceID={DeviceID}&Token={Token}&Language={Language}	获取某个设备的详细信息
POST api/DeviceInfo/PostUpdateDeviceInfo	修改指定设备的设备信息
GET api/DeviceInfo/GetUpdateDeviceInfo?DeviceID={DeviceID}&SimCard={SimCard}&DeviceName={DeviceName}&CarNum={CarNum}&SpeedLimit={SpeedLimit}&SpeedLimitTime={SpeedLimitTime}&CellName={CellName}&CellPhone={CellPhone}&Token={Token}&Language={Language}	修改指定设备的设备信息

Geofence

获取电子围栏信息接口

API	接口说明
POST api/Geofence/PostGeofenceList	获取电子围栏列表接口
GET api/Geofence/GetGeofenceList?DeviceID={DeviceID}&MapType={MapType}&TimeZone={TimeZone}&Token={Token}&Language={Language}	获取电子围栏列表接口
POST api/Geofence/PostDelGeofence	删除指定的电子围栏
GET api/Geofence/GetDelGeofence?GeofenceID={GeofenceID}&Token={Token}&Language={Language}	删除指定的电子围栏
POST api/Geofence/PostSaveGeofence	新增/修改一个电子围栏
GET api/Geofence/GetSaveGeofence?DeviceID={DeviceID}&UserID={UserID}&GeofenceID={GeofenceID}&MapType={MapType}&GeofenceName={GeofenceName}&GeofenceRemark={GeofenceRemark}&Latitude={Latitude}&Longitude={Longitude}&Radius={Radius}&GeofenceType={GeofenceType}&AlarmType={AlarmType}&Token={Token}&Language={Language}	新增/修改一个电子围栏

Map

地图相关数据获取接口

API	接口说明
POST api/Map/PostTracking	获取单个设备实时位置数据
GET api/Map/GetTracking?DeviceID={DeviceID}&MapType={MapType}&TimeZone={TimeZone}&Token={Token}&Language={Language}	获取单个设备实时位置数据
POST api/Map/PostHistory	获取单个设备历史轨迹数据，如果请求轨迹起止时间跨度较大，建议分批次少量获取轨迹数据，提升性能例如：一次获取200条
GET api/Map/GetHistory?DeviceID={DeviceID}&MapType={MapType}&TimeZone={TimeZone}&StartTime={StartTime}&EndTime={EndTime}&GetLBS={GetLBS}&GetCount={GetCount}&Token={Token}&Language={Language}	获取单个设备历史轨迹数据，如果请求轨迹起止时间跨度较大，建议分批次少量获取轨迹数据，提升性能例如：一次获取200条
POST api/Map/PostAddress	获取经纬度点对应的地址信息
GET api/Map/GetAddress?UserID={UserID}&OLatitude={OLatitude}&OLongitude={OLongitude}&Token={Token}&Language={Language}	获取经纬度点对应的地址信息
POST api/Map/PostCarInfoForRectangle	获取矩形区域内的设备信息
GET api/Map/GetCarInfoForRectangle?MapType={MapType}&TimeZone={TimeZone}&LeftTopLat={LeftTopLat}&LeftTopLng={LeftTopLng}&RightBottomLat={RightBottomLat}&RightBottomLng={RightBottomLng}&Token={Token}&Language={Language}	获取矩形区域内的设备信息
POST api/Map/PostCarInfoForCircle	获取圆区域内的设备信息
GET api/Map/GetCarInfoForCircle?MapType={MapType}&TimeZone={TimeZone}&Lat={Lat}&Lng={Lng}&Radius={Radius}&Token={Token}&Language={Language}	获取圆区域内的设备信息

Report

统计类相关接口

API	接口说明
POST api/Report/PostMileage	获取单个设备列表接口
GET api/Report/GetMileage?DeviceID={DeviceID}&TimeZone={TimeZone}&StartTime={StartTime}&EndTime={EndTime}&Token={Token}&Language={Language}	获取单个设备列表接口
POST api/Report/PostACCList	获取单个设备某段时间内ACC开关记录接口
GET api/Report/GetACCList?DeviceID={DeviceID}&TimeZone={TimeZone}&StartTime={StartTime}&EndTime={EndTime}&Token={Token}&Language={Language}	获取单个设备某段时间内ACC开关记录接口

UserInfo

用户相关接口

API	接口说明
POST api/UserInfo/PostLogin	登录接口
GET api/UserInfo/GetLogin?Name={Name}&Pass={Pass}&LoginType={LoginType}&Token={Token}&Language={Language}	登录接口
POST api/UserInfo/PostUpdatePwd	修改指定用户的密码接口
GET api/UserInfo/GetUpdatePwd?UserID={UserID}&OldPwd={OldPwd}&NewPwd={NewPwd}&Token={Token}&Language={Language}	修改指定用户的密码接口
POST api/UserInfo/PostChildrenUserList	获取下级用户信息接口
GET api/UserInfo/GetChildrenUserList?UserID={UserID}&Token={Token}&Language={Language}	获取下级用户信息接口