第二十三章 源代码文件 REST API 参考（五）

第二十三章 源代码文件 REST API 参考（五）

文章目录

​​第二十三章 源代码文件 REST API 参考（五）​​​​DeleteDoc​​

​​URL​​​​JSON Messages​​​​HTTP 返回码​​

​​HeadDoc​​

​​URL​​​​HTTP 返回码​​

​​GetDocs​​

​​URL​​​​JSON Messages​​​​HTTP 返回码​​

​​DeleteDocs​​

​​URL​​​​JSON Messages​​​​HTTP 返回码​​

第二十三章 源代码文件 REST API 参考（五）

DeleteDoc

此方法删除指定命名空间中的命名源代码文件。它返回相应的源代码文件对象。

与源代码文件有关的错误将在源代码文件对象的状态属性中。

有关示例和其他详细信息，请参阅本手册教程章节中的删除文件。

URL

​​DELETE ​​CSP​​​ 文件 ，则 ​​doc-name​​​ 的值包括 ​​/​​​（斜杠）字符。这就是定义 ​​DeleteDoc​​​ 的 ​​URLMap​​​ 包含此参数名称的 (​​.*​​​) 而不是 ​​:docname​​​ 的原因。有关详细信息，请参阅创建 ​​REST​​​ 服务中的“为 ​​REST​​ 创建 URL 映射”。

JSON Messages

以下是源代码文件 ​​xyz.mac​​​ 的 ​​DELETE​​ 的返回内容：

{ "status": { "errors": [], "summary": "" }, "console": [], "result": { "name": "xyz.mac", "db": "INVENTORYR", "ts": "", "cat": "RTN", "status": "", "enc": false, "flags": 0, "content": [] }}

HTTP 返回码

​​HTTP 200​​ 如果正常。如果命名资源不是有效的源代码文件名，则返回​​HTTP 400​​。如果源代码文件不存在，则返回​​HTTP 404​​。如果资源被锁定，​​HTTP 423​​。​​HTTP 500​​ 如果发生意外错误（详细信息将在状态错误数组中）。

HeadDoc

此方法返回命名源代码文件和命名空间的 ​​HttpHeader​​。此标头包含一个时间戳，可用于检测服务器和客户端版本之间的差异。

URL

​​HEAD ​​CSP​​​ 文件的 ​​HTTP​​​ 标头，则 ​​doc-name​​​ 的值包括 ​​/​​​（斜杠）字符。这就是定义 ​​HeadDoc​​​ 的 ​​URLMap​​​ 包含此参数名称的 (​​.*​​​) 而不是 ​​:docname​​​ 的原因。有关详细信息，请参阅创建 ​​REST​​ 服务中的“为 REST 创建 URL 映射”

HTTP 返回码

​​HTTP 200​​ 如果正常。如果资源名称是无效的源代码文件名，则返回​​HTTP 400​​。如果找不到资源，则返回​​HTTP 404​​。​​HTTP 500​​ 如果发生意外错误（详细信息将在状态错误数组中）。

GetDocs

此方法返回命名空间中所有指定源代码文件的文本。

URL

​​POST ​​请求的正文中传递。请求正文是要获取的源代码文件名称的 ​​JSON​​​ 数组。例如，​​[ "%Api.DocDB.cls", ... ]​​。

此调用需要标头 ​​Content-Type application/json​​。

JSON Messages

返回内容是源代码文件对象的数组。有关源代码文件对象结构的示例，请参见 ​​GetDoc​​ 方法。

与源代码文件有关的错误将出现在每个源代码文件对象的状态属性中。此方法不支持 ​​storageOnly​​​ 标志。它也不进行 ​​ETAG​​​ 检查（因此在任何情况下都不会返回 ​​HTTP 304​​）。

HTTP 返回码

​​HTTP 200​​ 如果正常。如果传递的内容类型不是​​application/json​​​，则​​HTTP 415​​。​​HTTP 500​​ 如果发生意外错误（详细信息将在状态错误数组中）。

DeleteDocs

此方法删除命名源代码文件的列表。它返回相应的源代码文件对象数组。

URL

​​DELETE ​​JSON​​​ 数组在 ​​请求的正文中传递。例如，​​[ "%Api.DocDB.cls", ... ]​​。

此调用需要标头 ​​Content-Type application/json​​。

JSON Messages

以下是源代码文件 ​​xyz.mac​​​ 和不存在的类 ​​noteexist.cls​​​ 的 ​​DELETE​​ 的返回内容：

{ "status": { "errors": [], "summary": "" }, "console": [ ], "result": [ { "name": "xyz.mac", "db": "INVENTORYR", "status": "" }, { "name": "notexist.cls", "db": "", "status": "ERROR #5001: Document Does Not Exist: User.notexist.cls [zExistsDoc+3^%Atelier.v1.Utils.General.1:%SYS]" } ]}

与每个源代码文件有关的错误将在每个返回的源代码文件对象的状态属性中。如果状态为空字符串，则源代码文件已成功删除。否则源代码文件不会被删除。

对于已删除的源代码文件，​​db​​ 属性将指示文档是从哪个数据库中删除的。

HTTP 返回码

​​HTTP 200​​ 如果正常。如果发布的数据不包含​​JSON​​​ 数组，则为​​HTTP 400​​。如果传递的内容类型不是​​application/json​​​，则​​HTTP 415​​。​​HTTP 500​​ 如果发生意外错误（详细信息将在状态错误数组中）。

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。