查询宠物档案列表
分页查询当前授权租户下的全部宠物档案信息。
请求地址
GET
/v1/ms-ai-fast/pet-profiles
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Query 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
page | integer | 否 | 1 | 当前查询页码,必须大于等于 1。 |
page_size | integer | 否 | 20 | 每页返回的档案记录数,最大不超过 100。 |
locale | string | 否 | 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
}
}| 参数名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,200 表示成功。 |
message | string | 状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。 |
data | object | 返回数据外层对象。 |
list | array | 宠物档案数组。 |
list[].id | integer | 宠物档案主键唯一 ID。作为后续发起智能问诊或图片识别的必填入参 pet_profile_id。 |
list[].name | string | 宠物昵称。 |
list[].pet_type | integer | 宠物物种类型:1 猫 (cat)、2 狗 (dog)、3 异宠 (other)。 |
list[].breed_code | string | 标准品种统一编码。 |
list[].breed_display_name | string | 本地化品种展示名称。 |
list[].pet_sex | integer | 性别:1 公、2 母、null 未知。 |
list[].pet_age | string | 格式化年龄展示文本。 |
list[].birthday | string | 宠物出生日期(YYYY-MM-DD)。 |
list[].weight | string | 体重(单位:kg)。 |
list[].is_neutered | integer | 绝育状态:0 未绝育、1 已绝育、null 未知。 |
list[].avatar | string | 宠物头像公网 URL。 |
total | integer | 符合条件的档案记录总数。 |
page | integer | 当前页码。 |
page_size | integer | 每页条数。 |