Skip to content

查询宠物档案列表 ​

分页查询当前授权租户下的全部宠物档案信息。

请求地址 ​

GET
/v1/ms-ai-fast/pet-profiles

请求参数 ​

请求头 ​

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

Query 参数 ​

参数名类型必填默认值说明
pageinteger否1当前查询页码,必须大于等于 1。
page_sizeinteger否20每页返回的档案记录数,最大不超过 100。
localestring否zh-CN返回文本的本地化语言代码,支持 zh-CN 与 en-US。

响应示例 ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "id": 44,
        "name": "糯米",
        "pet_type": 1,
        "breed_code": "cat.british-shorthair",
        "breed_display_name": "英国短毛猫",
        "pet_variety": "英国短毛猫",
        "pet_sex": 1,
        "pet_age": "1岁4个月",
        "birthday": "2024-05-01",
        "weight": "4.5",
        "is_neutered": 1,
        "avatar": "https://cdn.habitaxx.com/pets/44.jpg"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  }
}
参数名类型说明
codeinteger业务状态码,200 表示成功。
messagestring状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。
dataobject返回数据外层对象。
listarray宠物档案数组。
list[].idinteger宠物档案主键唯一 ID。作为后续发起智能问诊或图片识别的必填入参 pet_profile_id。
list[].namestring宠物昵称。
list[].pet_typeinteger宠物物种类型:1 猫 (cat)、2 狗 (dog)、3 异宠 (other)。
list[].breed_codestring标准品种统一编码。
list[].breed_display_namestring本地化品种展示名称。
list[].pet_sexinteger性别:1 公、2 母、null 未知。
list[].pet_agestring格式化年龄展示文本。
list[].birthdaystring宠物出生日期(YYYY-MM-DD)。
list[].weightstring体重(单位:kg)。
list[].is_neuteredinteger绝育状态:0 未绝育、1 已绝育、null 未知。
list[].avatarstring宠物头像公网 URL。
totalinteger符合条件的档案记录总数。
pageinteger当前页码。
page_sizeinteger每页条数。
最近更新

栖界开放平台 · API Documentation