三爪龙 物联网IO平台 为您提供安全放心的链接

关于三爪龙科技有限公司

三爪龙物联网平台介绍

用户登录

设备上报数据http://api.iom2m.com/objac/put

请求URL

http://api.iom2m.com/objac/put

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1
sn String 设备序列号

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
data(除key必需填外,其它节点按实际进行增减) json

为上报数据列表,可同时上报一条或多条,示例为:
[{"key":100001,"value":12.01}
,{"key":300001,"value":1}]

参数 类型 说明
key 32位int

100000至199999 为温度
200000至299999 为温度
300000至399999 为开关
400000至499999 为压力
500000至599999 为风力
600000至699999 为距离
700000至799999 为电压
800000至899999 为电流
900000至999999 为转速
1000000至1099999 为位置
1100000至1199999 为灯,带开关和RGB分量
1200000至1299999 为摄像头/图像
1300000至1399999 为门禁
2147000000至2147999999 为其它自定义类型

value 可变  
x 位置X  
y 位置Y  
其它值  

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /objac/put?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive


{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

读取控制数据http://api.iom2m.com/objac/get

请求URL

http://api.iom2m.com/objac/get

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1
sn String 设备序列号

 

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号

 

响应内容:

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1
sn String 设备序列号
data Json/Array

[{"key":100001,"value":12.01,"objid":123," time ":1504853117}
,{"key":300001,"value":1,"objid":123,"time":1504853117}]

完整的HTTP请求报文: POST /objac/get?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Content-Type: application/x-www-form-urlencoded
Host: api.iom2m.com
Connect-Length: 19
Connection: Keep-Alive

{"objid":1000000031}
返回示例:
{"ret":0,"error":"OK","tick":1504853117,"data":[{"key":100001,"value":12.01,"objid":12345678,"time":1504853117},{"key":300001,"value":1,"objid":12345678,"time":1504853117}]}

执行控制命令http://api.iom2m.com/objac/set

请求URL

http://api.iom2m.com/objac/set

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1
sn String 设备序列号

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
data json/Array

为[{"key":100001,"value":12.01}
,{"key":300001,"value":1}]

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例 :
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count int 接受了多少条按消息
data Json/Array

[{"key":100001,"value":12.01}
,{"key":300001,"value":1}]

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":2}

完整的HTTP请求报文: POST /objac/set?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Content-Type: application/x-www-form-urlencoded
Host: api.iom2m.com
Connect-Length: 126
Connection: Keep-Alive

{"objid":1000000031,"data":[{"key":100001,"value":12.01},{"key":300001,"value":1}]}

获取传感器数据报表http://api.iom2m.com/report/getiodata

请求URL

http://api.iom2m.com/report/getiodata

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据
nextid 分多页时,表示下一条记录开始标记 查下一页时,从上一页返回的数据中获得

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodata?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive

{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

获取传感器数据报表视图http://api.iom2m.com/report/getiodatamap

请求URL

http://api.iom2m.com/report/getiodatamap

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodatamap?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive

{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

获取设备布局结构http://api.iom2m.com/report/getdevobject

请求URL

http://api.iom2m.com/report/getdevobject

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodatamap?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive

{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

TCP长连接C/C++ Widows接口http://api.iom2m.com/report/getdevobject

请求URL

http://api.iom2m.com/report/getdevobject

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodatamap?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive

{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

TCP长连接C/C++ Linux接口http://api.iom2m.com/report/getdevobject

请求URL

http://api.iom2m.com/report/getdevobject

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodatamap?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive

{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

TCP长连接安卓接口http://api.iom2m.com/report/getdevobject

请求URL

http://api.iom2m.com/report/getdevobject

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodatamap?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive

{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

TCP长连接IOS接口http://api.iom2m.com/report/getdevobject

请求URL

http://api.iom2m.com/report/getdevobject

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodatamap?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive

{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

TCP长连接C#接口http://api.iom2m.com/report/getdevobject

请求URL

http://api.iom2m.com/report/getdevobject

请求方式

POST

请求参数(写在URL后面的参数)

请求参数 参数类型 参数说明
tick long 时间随机数
checksum String 加密验证数据,checksum计算见附表1

POST内容:

请求参数 参数类型 参数说明
objid 64位long 设备ID号
key 32位long 设备的传感器编号
starttm yyyy-MM-dd hh:mm:ss 开始时间
endtm yyyy-MM-dd hh:mm:ss 结束时间(可选,如果未填表示到当前时间点)
type 1,2,3,4,5 1表示实时数据
2表示按分钟平均值数据
3表示按每小时平均值数据
4表示按天数据
5表示按周平均值数据.
默认获取实时数据

 

注意:
上传数据中key的类型,强烈建议按上报定义的区间使用,否则后期将可能会出现其它问题。例如有多个温度传感器采集的值,key可以在100000至199999任意选一个。但开关值不能在100000至199999这个区间,开关值应该在300000至399999选。

上传数据示例
{
"objid": 1000000031,
"data": [
{
"key": 100001,
"value": 12.01
},
{
"key": 300001,
"value": 1
},
{
"key": 1000000,
"x": 101.123123,
"y": 36.45685
}
]
}

响应内容:

返回参数 参数类型 参数说明
ret 32位int 错误码,为0表示成功,其他见错误码表
tick 32位int 当前系统时间截
error String 如果ret=0则为OK,否则为错误描述信息
count 32位int 接收了多少条状态

返回示例代码
{"ret":0,"error":"OK","tick":1504853117,"count":3}

完整的HTTP请求报文: POST /report/getiodatamap?tick=152152145&checksum=256965214585236A012D5245852D125D&sn=55458785452154525185 HTTP/1.1
Accept: */*
User-Agent: szl/m2mclient
Host: api.iom2m.com
Connect-Length: 126
Content-Type: application/x-www-form-urlencoded
Connection: Keep-Alive


{"objid":1000000031, "data":[{"key":100001,"value":12.01},{"key":300001,"value":1},{"key":1000000,"x":101.123123,"y":36.45685}]}

POST数据时检验码计算

将POST的Json格式数据(不包括tick,checksum,sn)进行sha1计算,然后转成16进制形式。
生成

参考代码(pData为要POST的数据, nBufLen为POST数据长度,如果是GET则nBufLen==0且pData==NULL, g_userData.szSn为设备序列号, g_userData.szKey为分配的KEY,g_userData.szObjid为分配的设备ID, nNowSystemTick为当前系统时间)
if(pData!=NULL && nBufLen>0)
{
SHA1((const uint8_t *)pData,nBufLen,checksum);
}
else
{
sprintf((char *)checksum,"%s",g_userData.szSn);
}
sprintf(netbuf1k_2,"data_%s_key_%s_sn_%s_id_%s_tm_%d",checksum,g_userData.szKey,g_userData.szSn,g_userData.szObjid,nNowSystemTick);
nDataLen=strlen(netbuf1k_2);
SHA1((const uint8_t *)netbuf1k_2,nDataLen,checksum);
for(nRetlen=0;nRetlen<16;nRetlen++)
{
sprintf(netbuf1k_2+nRetlen*2,"%02x",(u8)checksum[nRetlen]);
}
netbuf1k_2[32]=0;