Appearance
删除宠物档案
功能介绍
本文档介绍了如何通过API删除宠物档案。当用户不再需要某个宠物的档案信息时(如宠物更换主人、信息录入错误需要重建、或其他原因),可以使用此接口将宠物档案从系统中删除。删除操作将移除与该宠物相关的所有基础信息,此操作不可逆,请谨慎使用。
使用方法
开发者需要通过HTTP DELETE请求删除宠物档案,请求时需要提供宠物档案ID(pet_profile_id)作为唯一标识。系统会返回操作结果,状态码200表示删除成功。建议在执行删除操作前向用户显示确认提示,避免误操作导致数据丢失。删除后,该宠物档案ID将不再有效,相关的API调用也将失败。
适用场景
- 信息错误修正:当宠物信息录入错误且需要重新创建时,可先删除错误档案
- 宠物所有权变更:宠物更换主人时,原主人可选择删除宠物档案
- 应用数据清理:用户卸载应用或注销账号时,清理相关宠物档案数据
- 测试环境重置:开发测试过程中,清理测试创建的宠物档案数据
- 隐私保护需求:用户出于隐私考虑,要求删除宠物相关数据
开发者需要按照如下步骤完成:
调用接口:
请求方式: DELETE(HTTPS)
请求地址: https://ms-ai.chongzhiling.com/api/v1.0/ai-b/pet-profile?pet_profile_id=[宠物编号]&token=[ACCESS_TOKEN]
参数列表[query]:
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
pet_profile_id | number | 是 | 宠物档案ID |
token | string | 是 | 凭证令牌 |
返回参数说明:
无返回参数 状态:204