Skip to content

品种库查询 ​

查询平台标准品种库,用于取得宠物档案 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

请求参数 ​

请求头 ​

请求头类型必填说明
Authorizationstring是访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。

Query 参数 ​

参数名类型必填默认值说明
pets_typestring是—宠物物种类型。仅支持 cat(猫)或 dog(狗)。
is_sortinteger否0排序与聚合方式:0 按首字母聚合分组返回对象,1 返回平铺数组。
localestring否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"
      }
    ]
  }
}
参数名类型说明
codeinteger业务状态码,200 表示成功。
messagestring状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。
dataobject返回数据外层对象。
localestring本次返回的实际展示名语言代码(如 zh-CN)。
itemsobject | array品种列表。is_sort=0 时为首字母聚合字典对象;is_sort=1 时为平铺列表数组。
items[].breed_codestring全球稳定品种标准唯一编码(如 dog.shiba-inu),写入宠物档案时传此值。
items[].display_namestring该品种在当前 locale 下的本地化展示名称。
featured_itemsarray平台推荐的热门/常见品种列表。
featured_items[].breed_codestring推荐品种标准编码。
featured_items[].display_namestring推荐品种展示名称。
featured_items[].image_urlstring推荐品种代表性图片封面 URL。
最近更新

栖界开放平台 · API Documentation