创建宠物档案
为用户录入并创建新的宠物健康档案。档案 ID 将作为后续所有健康问诊和图片分析的核心上下文载体。
请求地址
POST
/v1/ms-ai-fast/pet-profiles
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 application/json。 |
请求体 (Body)
json
{
"name": "糯米",
"pet_type": 1,
"breed_code": "cat.british-shorthair",
"pet_variety": "英国短毛猫",
"pet_sex": 1,
"birthday": "2024-05-01",
"weight": "4.5",
"is_neutered": 1,
"avatar": "https://cdn.habitaxx.com/pets/44.jpg"
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 宠物昵称(长度限制 1~32 个字符)。 |
pet_type | integer | 是 | 物种类型:1 猫 (cat)、2 狗 (dog)、3 异宠 (other)。 |
breed_code | string | 否 | 标准品种编码(通过品种库接口查询获取,如 cat.british-shorthair)。猫狗推荐必填。 |
pet_variety | string | 否 | 自定义品种文本(异宠或未收录品种时填写)。 |
pet_sex | integer | 否 | 性别:1 公、2 母、null 未知。 |
birthday | string | 否 | 出生日期(格式 YYYY-MM-DD)。 |
weight | string | 否 | 体重数值(kg,如 "4.5")。 |
is_neutered | integer | 否 | 绝育状态:0 未绝育、1 已绝育。 |
avatar | string | 否 | 头像图片公网 URL。 |
响应示例
json
{
"code": 200,
"message": "success",
"data": {
"id": 44,
"name": "糯米",
"pet_type": 1,
"breed_code": "cat.british-shorthair",
"pet_sex": 1,
"birthday": "2024-05-01"
}
}| 参数名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,200 表示创建成功。 |
message | string | 状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。 |
data | object | 新建成功的宠物档案对象。 |
id | integer | 系统生成的宠物档案唯一自增 ID。请妥善保存用于后续问诊与识别。 |
name | string | 宠物昵称。 |
pet_type | integer | 物种类型:1 猫、2 狗、3 异宠。 |
breed_code | string | 绑定的标准品种编码。 |
pet_sex | integer | 性别代码。 |
birthday | string | 出生日期。 |