云上畜牧开放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. 接口列表

4.牲畜绑定智能耳标

POST
/openapi/labelRegister
该接口目前是同步,因此建议单次耳标登记数量不超过50个,后续我们会将其优化成异步。
注意:
labelNumbers数组中的对象,计算签名时候需要进行排序
java使用@JSONField(ordinal = 序号)
1 weight, 2 url, 3 number, 4 femaleNumber, 5 age

请求参数

Body 参数application/json
farmName
string 
养殖场名称
必需
type
integer 
必需
养殖场类型 1猪 2牛
labelNumbers
array [object {5}] 
耳标编号
必需
number
string 
耳标号
必需
femaleNumber
string 
必需
母扣号,如果没有就空字符串
age
integer 
日龄
必需
weight
integer 
体重(斤)
必需
示例值:
108
url
string  | null 
登记照片
可选
typeId
integer 
必需
类别id(调用类别列表接口,取出牛只对应类别id)
breedId
integer 
必需
品种id(调用品种列表接口,取出牛只对应品种id)
placeName
string 
栋舍名称
必需
columnName
string 
栏号名称
必需
appid
string 
apid
必需
noncestr
string 
当前时间戳
必需
sign
string 
必需
签名(详见接口对接说明-sign算法说明)
示例
{
	"farmName": "内蒙古养殖场",
	"type": "1",
	"labelNumbers": [
		{
			"number": "123456",
			"femaleNumber": "5555555",
			"age": 100,
			"weight": 200,
			"url": "http://xxx.jpg"
		}
	],
	"typeId": "101",
	"breedId": "605113810780426240",
	"placeName": "1号舍",
	"columnName": "1号栏",
	"appid": "589150557873111040",
	"noncestr": "1655111857793",
	"sign": "D0BDC82105E8B145E12DE98624C8521B"
}

示例代码

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/labelRegister' \
--header 'Content-Type: application/json' \
--data-raw '{
	"farmName": "内蒙古养殖场",
	"type": "1",
	"labelNumbers": [
		{
			"number": "123456",
			"femaleNumber": "5555555",
			"age": 100,
			"weight": 200,
			"url": "http://xxx.jpg"
		}
	],
	"typeId": "101",
	"breedId": "605113810780426240",
	"placeName": "1号舍",
	"columnName": "1号栏",
	"appid": "589150557873111040",
	"noncestr": "1655111857793",
	"sign": "D0BDC82105E8B145E12DE98624C8521B"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
修改于 2024-04-24 02:31:46
上一页
3.获取牲畜品种列表
下一页
5.设备绑定养殖场
Built with