云上畜牧开放api
  1. 接口列表
云上畜牧开放api
  • 1.文档说明
  • 2.接口对接说明
  • 3.消费者接入说明
  • 4.未对接数据而直接出货的处理方案
  • 接口列表
    • 1.创建养殖场
      POST
    • 2.获取牲畜类别列表
      POST
    • 3.获取牲畜品种列表
      POST
    • 4.牲畜绑定智能耳标
      POST
    • 5.设备绑定养殖场
      POST
    • 6.获取网关设备列表
      POST
    • 7.获取AI摄像机视频直播地址
      POST
    • 8_1.获取AI摄像机视频回放地址1
      POST
    • 8_2.获取AI摄像机视频回放地址2
      POST
    • 9.获取商户名下所有养殖场
      POST
    • 10.根据养殖场获取养殖栋舍
      POST
    • 11.根据栋舍id获取栏号列表
      POST
    • 12.根据条件查询牲畜基本信息(电子档案)
      POST
    • 获取牲畜发情时间段
      POST
    • 获取牲畜配种记录
      POST
    • 获取牲畜检疫记录
      POST
    • 13.替换新耳标
      POST
    • 14.触发耳标告警灯(点亮耳标)
      POST
  1. 接口列表

14.触发耳标告警灯(点亮耳标)

POST
/openapi/lightUpLabel
流程:商户平台->云上畜牧API->设备->耳标。
1、当商户调用该接口时,云上平台会下发指令到最近一次读取到该耳标的设备(若不指定设备号)上,例如有5台设备读取到某个耳标,但下发指令时只会给最后读取到耳标的那台;
2、当设备周边耳备越多时,耳标点亮的时间越快,例如,当设备周边有几十个耳标时,下发指令几秒后耳标就能点亮闪灯,而当设备周边只有1个耳标时,可能需要接近一分钟才能点亮;
3、同一设备30秒内只能点亮几个耳标,请结合实际应用场景调用该接口;
4、闪灯时间为2分钟。

请求参数

Body 参数application/json
labelNumber
string 
耳标号
必需
deviceCode
string 
设备号
可选
若不指定设备号,则取最近一次读取到该耳标的设备,由该设备下发点亮指令
appid
string 
必需
sign
string 
签名
必需
noncestr
string 
时间戳
必需
示例
{
    "labelNumber": "100000100075094",
    "deviceCode": "537470A002E003C",
    "appid": "1234567890123",
    "sign": "ASDFGHJKL",
    "noncestr": "1733379256693"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/openapi/lightUpLabel' \
--header 'Content-Type: application/json' \
--data-raw '{
    "labelNumber": "100000100075094",
    "deviceCode": "537470A002E003C",
    "appid": "1234567890123",
    "sign": "ASDFGHJKL",
    "noncestr": "1733379256693"
}'

返回响应

🔴500服务器错误
application/json
Body
data
null 
必需
code
integer 
必需
message
string 
必需
page
null 
必需
extParam
null 
必需
success
boolean 
必需
示例
{
    "data": null,
    "code": 500,
    "message": "设备不存在",
    "page": null,
    "extParam": null,
    "success": false
}
修改于 2024-12-09 07:20:49
上一页
13.替换新耳标
Built with