品种库查询
查询平台标准品种库,用于取得宠物档案 breed_code 的合法取值,以及该品种在当前语言下的展示名(即档案响应里的 breed_display_name)。
pets_type 与档案的 pet_type 不是同一个字段
品种库接口的 pets_type 接收字符串 cat / dog;写入宠物档案时用的是数字 pet_type(1 猫、2 狗、3 异宠)。两者需要调用方自行映射,不能互传。
请求地址
GET
/v1/ms-ai-fast/pets/pet-info
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Query 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
pets_type | string | 是 | — | 宠物物种类型。仅支持 cat(猫)或 dog(狗)。 |
is_sort | integer | 否 | 0 | 排序与聚合方式:0 按首字母聚合分组返回对象,1 返回平铺数组。 |
locale | string | 否 | zh-CN | 品种展示名语言,支持 zh-CN 与 en-US。 |
响应示例:按首字母分组(is_sort=0)
json
{
"code": 200,
"message": "success",
"data": {
"locale": "zh-CN",
"items": {
"A": [
{ "breed_code": "cat.egyptian-mau", "display_name": "埃及猫" }
],
"B": [
{ "breed_code": "cat.ragdoll", "display_name": "布偶猫" }
]
},
"featured_items": [
{
"breed_code": "cat.ragdoll",
"display_name": "布偶猫",
"image_url": "https://upload.suoweilai.com/pets_image/buoumao.png"
}
]
}
}响应示例:平铺数组(is_sort=1)
json
{
"code": 200,
"message": "success",
"data": {
"locale": "zh-CN",
"items": [
{ "breed_code": "dog.irish-wolfhound", "display_name": "爱尔兰猎狼犬" },
{ "breed_code": "dog.shiba-inu", "display_name": "柴犬" }
],
"featured_items": [
{
"breed_code": "dog.shiba-inu",
"display_name": "柴犬",
"image_url": "https://upload.suoweilai.com/pets_image/chaiqvan.png"
}
]
}
}| 参数名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,200 表示成功。 |
message | string | 状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。 |
data | object | 返回数据外层对象。 |
locale | string | 本次返回的实际展示名语言代码(如 zh-CN)。 |
items | object | array | 品种列表。is_sort=0 时为首字母聚合字典对象;is_sort=1 时为平铺列表数组。 |
items[].breed_code | string | 全球稳定品种标准唯一编码(如 dog.shiba-inu),写入宠物档案时传此值。 |
items[].display_name | string | 该品种在当前 locale 下的本地化展示名称。 |
featured_items | array | 平台推荐的热门/常见品种列表。 |
featured_items[].breed_code | string | 推荐品种标准编码。 |
featured_items[].display_name | string | 推荐品种展示名称。 |
featured_items[].image_url | string | 推荐品种代表性图片封面 URL。 |