gift
18 个接口(读 8 / 写 10) · 其中 8 个高危 · 凭证范围:查询需 office:read,写操作需 office:write
| 接口 | 编码 | 后端签名 | |
|---|---|---|---|
| POST 高危 | 创建礼品申请并提交审批 | office.gift.create | /v1/gifts/create |
| POST 高危 | 删除礼品申请 | office.gift.delete | /v1/gifts/delete |
| POST 高危 | 发放礼品(扣减礼品库存) | office.gift.deliver | /v1/gifts/deliver |
| GET | 礼品申请详情 | office.gift.detail | /v1/gifts/detail |
| POST | 保存礼品申请草稿 | office.gift.draft | /v1/gifts/draft |
| POST 高危 | 删除礼品库存 | office.gift.inventory.delete | /v1/gifts/inventory/delete |
| POST | 礼品库下拉选项(库存>0) | office.gift.inventory.options | /v1/gifts/inventory/options |
| POST | 礼品库存分页 | office.gift.inventory.page | /v1/gifts/inventory/page |
| POST 高危 | 新增或编辑礼品库存 | office.gift.inventory.save | /v1/gifts/inventory/save |
| POST 高危 | 礼品入库(增加库存) | office.gift.inventory.stock-in | /v1/gifts/inventory/stock-in |
| POST | 礼品清单分页(申请明细展开) | office.gift.item.page | /v1/gifts/items/page |
| POST | 礼品库流水分页 | office.gift.ledger.page | /v1/gifts/ledger/page |
| POST | 礼品库流水汇总 | office.gift.ledger.summary | /v1/gifts/ledger/summary |
| POST | 礼品申请分页 | office.gift.page | /v1/gifts/page |
| GET | 礼品申请项目下拉选项 | office.gift.project.options | /v1/gifts/project/options |
| POST 高危 | 重新提交礼品申请审批 | office.gift.submit-draft | /v1/gifts/submit-draft |
| POST | 编辑草稿礼品申请 | office.gift.update-draft | /v1/gifts/update-draft |
| POST 高危 | 撤回礼品申请 | office.gift.withdraw | /v1/gifts/withdraw |
调用协议(各页通用)
本实体接口统一通过 POST https://open.risemap.cn/v1/api/invoke 调用,用 apiCode 指定接口。
JSON 响应为统一信封 { code, message, data },文件接口成功时直接返回文件;
错误码见错误码说明;凭证获取与调用协议见开放接口清单。
示例中的鉴权头为 OAuth 访问令牌形态;AppKey 集成商换成 -H "X-App-Key: <appKey>" -H "X-App-Secret: <appSecret>" 即可,其余不变。
所有调用以绑定员工身份执行,员工须具备对应主站功能权限(默认按后端接口 URL 自动对照,个别接口单独标注权限码)。
本页由接口注册表与后端接口规格自动生成。