---
name: "updatePet"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.6.27" }
title: "updatePet - 更新宠物信息"
---

## updatePet

> [VERSION] @ray-js/ray >= 1.6.27

### 描述

更新宠物信息

### 参数

| 属性 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `data` | `Partial` | 是 | 请求参数：需包含 id、ownerId 及待更新字段，详见类型 PetUpdate |

##### Partial 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `ownerId` | `string` | 否 | - | 家庭id |
| `petType` | `"cat" \| "dog"` | 否 | - | 宠物类型 |
| `name` | `string` | 否 | - | 宠物名字，不能超过40个字符 |
| `avatar` | `string` | 否 | - | 宠物头像路径，以 "smart/" 开头 |
| `sex` | `number` | 否 | - | 性别. 0-雌性, 1-雄性, 2-绝育雌性, 3-绝育雄性 |
| `activeness` | `number` | 否 | - | 活跃度，0-不活跃，1-正常，2-非常活跃 |
| `birth` | `number` | 否 | - | 生日, 单位: 毫秒 |
| `weight` | `number` | 否 | - | 体重，单位为g |
| `breedCode` | `string` | 否 | - | 品种code(从宠物品种列表接口获取) |
| `rfid` | `string` | 否 | - | rfid |
| `id` | `number` | 否 | - | 宠物id |
| `devIds` | `string[]` | 否 | - | 关联设备IDs |
| `foodId` | `number` | 否 | - | 关联主粮ID |
| `extInfo` | `string` | 否 | - | 额外信息，不要放敏感信息 |
| `idPhotos` | `IdPhotos[]` | 否 | - | 宠物正面照 |
| `features` | `Feature[]` | 否 | - | 宠物特征code |
| `personalities` | `string[]` | 否 | - | 宠物性格code |
| `timeZone` | `string` | 否 | - | 时区 |
| `dataType` | `string` | 否 | - | 业务数据类型 |


### 返回值

类型: `Promise<boolean>`

Promise，resolve 值为是否更新成功（boolean）

### 示例代码

#### 请求示例

```typescript
import { updatePet } from '@ray-js/ray';

updatePet({
  id: 1,
  ownerId: 'xxxx',
  petType: 'cat',
  name: '福宝',
  avatar: 'smart/xxxx/xxxx/xxxx',
  sex: 1,
  activeness: 1,
  birth: 1614528000000,
  weight: 5000,
  breedCode: 'xxx',
  idPhotos: [
    {
      angle: 'firstFront',
      objectKey: 'xxxx',
    },
  ],
  features: [
    {
      category: 'eyeColor',
      details: ['棕色'],
    },
  ],
});
```

#### 返回示例

```json
true
```