广发云服务API（初步）

• 中的可用功能PGF服务API,
• 中的命令提供的功能GF外壳,
• 一些附加服务语法编译和文件在云中的持久存储。

这是初步的，可能会更改！

可用性和协议

该服务可从以下位置获得http://cloud.grammaticalframework.org/.在自己的计算机上安装了GF的用户也可以通过使用命令启动GF本地运行服务gf-服务器.

使用GET或POST方法通过HTTP发出请求。（以下示例显示GET请求，但对于更改状态的请求，首选POST在服务器上。）

请求中的数据位于应用程序/x-www-form-urlencoded格式（web浏览器在提交表单数据时默认使用的格式）。

响应中的数据通常为JSON格式。HTTP响应代码通常为200，但也可以是204（文件上传后），404（找不到要下载或删除的文件），400（用于无法识别的命令或请求中缺少/不可接受的参数）或501（对于不支持的HTTP请求方法）。请求中无法识别的参数将被自动忽略。

请求

PGF服务

http://cloud.sgrammaralframework.org/grammars/Foods.pgf？command=随机

[{“树”：“Pred（那个披萨）（很无聊）”}]

有关更多信息，请参阅：

• PGF web服务API示例.
• PGF web服务API文档.

广发壳牌服务

/gfshell？目录=...&命令=i+Foods.pgf

 

/gfshell？目录=...&命令=gr

Pred（那个披萨）（很无聊）

/gfshell？目录=...&command=ps+-lextext+%22那个+pizza+很无聊。%22

那披萨很无聊。

• GF外壳参考

其他云服务

/新

这会在服务器上生成一个新的工作目录，例如。/tmp/gfse.123456.大多数云服务命令都需要一个工作目录在中指定目录参数。工作目录是持久的，因此需要客户端记住并重新使用它。访问以前的上传的文件需要使用相同的工作目录。

/解析？路径=来源

此命令可用于检查GF源代码的语法错误。它还将GF源代码转换为中使用的JSON表示GFSE（基于云的GF语法编辑器）。

/云？目录=...&命令=上传&路径₁=来源₁&路径₂=来源₂&...

上传要存储在云中的文件。如果上传成功，则响应代码为204。

/云？目录=...&命令=制作&路径₁=来源₁&路径₂=来源₂&...

上传语法文件并将其编译为PGF文件。回答示例：

{“errorcode”：“确定”，//“OK”或“Error”
“命令”：“gf-s-make FoodsEng.gf FoodsSwe.gf FoodesChi.gf”，
“输出”：“\n\n”//GF发出的警告和错误
}

/云？目录=...&命令=重新制作&路径₁=来源₁&路径₂=来源₂&...

喜欢命令=制作，除非你可以离开这个来源_我清空部件以重用先前上载的文件夹。

/云？目录=...&命令=下载&文件=路径

下载指定的文件。

/云？目录=...&命令=最小二乘法&ext=.pgf（扩展名）

列出具有指定扩展名的文件，例如。[“Foods.pgf”，“Letter.pgf”].

/云？目录=...&命令=远程管理&文件=路径

删除指定的文件。

/云？目录=...&命令=链接目录&新目录=...

合并服务器目录。GFSE使用它来共享语法在多个设备之间。

真实航向