YesDev
HTTP/HTTPS
Protocol
YesDev / Platform API / 需求更新，按需更新
需求更新，按需更新
API Url：http://pre.www.yesdev.cn/api/platform.php?s=Platform.PRD_Need.UpdateNeedLite
API Description： 可以进行按需更新，更新需求的信息
API Parameters
| Parameter Name | Type | Is Required | Default | Note | Description |
|---|---|---|---|---|---|
| access_token | 字符串 | Optional | 访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口 | ||
| app_key | 字符串 | Optional | app_key，团队代码 | ||
| sign | 字符串 | Optional | - | 动态签名，签名算法请联系我们技术客服获取 | |
| id | 整型 | Required | - | ID | |
| need_name | 字符串 | Optional | - | max: 500 | 需求名称 |
| need_check_status | 整型 | Optional | - | 需求评审状态，0待评审1已评审2不需要评审 | |
| need_status | 整型 | Optional | - | 需求状态，0需求中100设计中200排期中300研发中310待测试400测试中410待发布500已上线600已完成700挂起 | |
| product_category_id | 整型 | Optional | - | 产品线ID | |
| product_category_version_id | 整型 | Optional | 0 | 产品线版本id | |
| need_from | 字符串 | Optional | - | max: 200 | 需求方 |
| need_start_date | 字符串 | Optional | - | 计划开始时间 | |
| need_finish_date | 字符串 | Optional | - | 计划完成时间 | |
| need_content | 字符串 | Optional | - | 需求内容 | |
| need_note | 字符串 | Optional | - | 备注 | |
| note_content_remark | 字符串 | Optional | - | 备注，支持富文本，辅助信息，用于消息推送,同时添加一条备注 | |
| need_level | 整型 | Optional | - | max: 4 | 优先级，0低1中2高3紧急 |
| charge_staff_id | 整型 | Optional | - | 需求负责人员工ID | |
| test_charge_staff_id | 整型 | Optional | - | 测试负责人员工ID | |
| version_nums | 字符串 | Optional | 0 | 编辑时使用的版本号 | |
| outside_charge_name | 字符串 | Optional | - | max: 50 | 外部对接人 |
| prd_id | 字符串 | Optional | - | max: 50 | 需求关联prd |
| need_content_email | 字符串 | Optional | - | max: 50 | 需求内容通知 |
| project_id | 整型 | Optional | - | 关联项目ID | |
| note_from_channel | 字符串 | Optional | - | 备注来源 | |
| notice_staff_ids | 字符串 | Optional | 通知成员消息 | ||
| need_plan_id | 字符串 | Optional | - | 需求规划id | |
| is_delay_reminder | 整型 | Optional | - | 是否延期 | |
| delay_reminder_day_nums | 整型 | Optional | - | 延期天数 | |
| is_submit_test | 整型 | Optional | 0 | 是提交测的，1是提交 0 不提交 | |
| custom_field_value | 数组json | Optional | - | 需求自定义字段，格式：{"系统KEY":"值","_CFKEY_1":"xxx"} | |
| need_parent_id | 整型 | Optional | - | 父需求ID | |
| need_weight | 整型 | Optional | - | min: 0 | 需求权重 |
Return Field
| Response Result | Type | Description |
|---|---|---|
| ret | int | status code, 200 is ok, 4xx is bad request, 5xx is server inside error |
| data | object/mixed | business data, decided by API implementation |
| data.is_updated | 整型 | 是否更新 |
| msg | string | message, usually error message |
Test Online
| Parameter | Is Required | Value |
|---|---|---|
| service | Required | |
| access_token | Optional | |
| app_key | Optional | |
| sign | Optional | |
| id | Required | |
| need_name | Optional | |
| need_check_status | Optional | |
| need_status | Optional | |
| product_category_id | Optional | |
| product_category_version_id | Optional | |
| need_from | Optional | |
| need_start_date | Optional | |
| need_finish_date | Optional | |
| need_content | Optional | |
| need_note | Optional | |
| note_content_remark | Optional | |
| need_level | Optional | |
| charge_staff_id | Optional | |
| test_charge_staff_id | Optional | |
| version_nums | Optional | |
| outside_charge_name | Optional | |
| prd_id | Optional | |
| need_content_email | Optional | |
| project_id | Optional | |
| note_from_channel | Optional | |
| notice_staff_ids | Optional | |
| need_plan_id | Optional | |
| is_delay_reminder | Optional | |
| delay_reminder_day_nums | Optional | |
| is_submit_test | Optional | |
| custom_field_value | Optional | |
| need_parent_id | Optional | |
| need_weight | Optional |
Client Request Demo
# 暂无示例，可添加示例文件：./src/view/docs/demos/Platform.PRD_Need.UpdateNeedLite.jsonError List
| Error Status | Error Description |
|---|---|
| 400 | ret=400，客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406，access_token令牌校验不通过 |
| 407 | ret=407，app_key权限不足，或未知应用 |
| 408 | ret=408，当前用户禁止使用，或用户未登录 |
| 410 | 权限不足 |
| 500 | 表示服务端内部错误 |
Last generated at: 2025-08-03 17:30:16 联系我们开通接入OpenAPI