775 Star 1.5K Fork 351

开源中国 / Gitee Feedback

 / 详情

Gitee OpenAPI 文档存在描述不清的情况

已拒绝
Bug
创建于  
2018-11-19 15:57

问题描述

https://gitee.com/api/v5/swagger#/putV5ReposOwnerRepoContentsPath
在本文中,参数“sha”被描述为“文件被替换的sha值”,但并未说明具体是哪个文件的sha,“被替换”也意义不明,也没写清具体是哪一个SHA算法,我尝试了SHA-1,SHA-256,SHA-224,SHA-512均未成功,返回错误结果为“Blob SHA does not match”。

重现步骤

期望效果

文档清晰到可以使人正常使用该API。

实际效果

我尝试对BASE64编码后的数据进行了各种SHA算法的摘要,然后用对BASE64编码前的数据进行了各种SHA算法的摘要,均报为“Blob SHA does not match”,原因不明。

评论 (5)

许兴逸 创建了任务

sha 为 修改前的文件 sha,可以通过获取文件内容得到,我也是试出来的

诺墨 负责人设置为Jim
诺墨 里程碑设置为社区版19-01
诺墨 添加协作者诺墨
Jim 通过oschina/gitee Pull Request !5771任务状态待办的 修改为已完成
许兴逸 任务状态已完成 修改为待办的

问题更新:git的blob需要加入一个头部才可以获得sha,否则不匹配。

头部为UTF8编码的:
blob <字节数><'\0'>

比如长度为512字节的内容,头部则为UTF8编码的:
blob 512
注意后面紧跟0字符

但是文档里尚未描述这种情况

@许兴逸 感谢反馈,请问是获取文件 sha 相关的接口
获取仓库具体路径下的内容
有这种情况吗? 我这边用 postman 暂未重现,需要提供更多信息,如仓库地址 :)

Jim 任务状态待办的 修改为已拒绝

@JHuZhang 啊,我这边的做法是把文件扒下来手动获取sha来着,然后发现怎么获取都获取不对,后来查了资料发现,需要加上文件头再sha。

诺墨 将工作项从 缺陷 迁移到 Bug
Jim 任务类型缺陷 修改为Bug

登录 后才可以发表评论

状态
负责人
项目
Pull Requests
关联的 Pull Requests 被合并后可能会关闭此 issue
分支
开始日期   -   截止日期
-
置顶选项
优先级
预计工期 (小时)
参与者(4)
699552 kids return 1578931078 488657 luma 1672886368 139536 jimcheung 1620399869 551147 normalcoder 1578927376
Ruby
1
https://gitee.com/oschina/git-osc.git
git@gitee.com:oschina/git-osc.git
oschina
git-osc
Gitee Feedback

搜索帮助