第二十三章 源代码文件 REST API 参考(五)
第二十三章 源代码文件 REST API 参考(五)
DeleteDoc
此方法删除指定命名空间中的命名源代码文件。它返回相应的源代码文件对象。
与源代码文件有关的错误将在源代码文件对象的状态属性中。
有关示例和其他详细信息,请参阅本手册教程章节中的删除文件。
URL
DELETE http://server:port/api/atelier/v1/namespace/doc/doc-name
注意:如果要删除 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 http://server:port/api/atelier/v1/namespace/doc/doc-name
注意:如果正在获取 CSP
文件的 HTTP
标头,则 doc-name
的值包括 /
(斜杠)字符。这就是定义 HeadDoc
的 URLMap
包含此参数名称的 (.*
) 而不是 :docname
的原因。有关详细信息,请参阅创建 REST
服务中的“为 REST 创建 URL 映射”
HTTP 返回码
HTTP 200
如果正常。- 如果资源名称是无效的源代码文件名,则返回
HTTP 400
。 - 如果找不到资源,则返回
HTTP 404
。 HTTP 500
如果发生意外错误(详细信息将在状态错误数组中)。
GetDocs
此方法返回命名空间中所有指定源代码文件的文本。
URL
POST http://server:port/api/atelier/v1/namespace/docs
要获取的源代码文件列表在 http
请求的正文中传递。请求正文是要获取的源代码文件名称的 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 http://server:port/api/atelier/v1/namespace/docs
要删除的文件列表作为 JSON
数组在 http
请求的正文中传递。例如,[ "%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
如果发生意外错误(详细信息将在状态错误数组中)。