Inputs:模板中带标签的变量
POST /inputs 读取模板,并按定义顺序列出其带标签的变量:即可以为其提供的值。可用于为模板构建表单,或在运行模板之前检查它需要哪些输入。
请求正文只需模板:template(或 source),如果单位不是毫米,还需提供 units。无需提供任何值。
示例
POST /inputs
X-API-KEY: your-api-key
Content-Type: application/json
{ "template": "L=400,\"Length\"\nW=300,\"Width\"\nP1=[L,0]\nP2=[L,W]\nP3=[0,W]\nPOLYLINE @1,[P0,P1,P2,P3],TRUE,0" }
{
"description": "",
"inputs": [
{ "name": "L", "label": "Length", "kind": "Number", "value": 400, "choices": [] },
{ "name": "W", "label": "Width", "kind": "Number", "value": 300, "choices": [] },
{ "name": "D", "label": "Depth", "kind": "Number", "value": 300, "choices": [] }
]
}
每个输入都有其 kind:Number、Text、Toggle(true 或 false)或 Choice。选项会在
choices 中列出可选的内容,其 value 为模板中所选项的位置(从 0 开始)。description 是模板对自身的说明:即模板开头的注释行。L、W 和 D 是图纸的标准尺寸,在每张图纸中都带有标签,因此总会被列出。
无法读取的模板会返回 400,并说明原因。