1.5.16 云市场API

优质

小牛编辑

136浏览

2023-12-01

更新时间：2019-07-18 11:17:56

节点简介

云市场节点允许您调用在阿里云市场中购买的API——如天气预报，身份证识别等，并可以根据返回的数据开发各种业务逻辑。有关该节点的使用案例，可以查看“模板”下的“天气控制加湿”案例。

使用场景

当您需要使用外部API功能的时候——比如根据城市PM2.5决定净化器是否需要开启等，您可以先在阿里云市场购买对应的API使用次数，然后在该节点进行配置调用。

配置项

请求方式

支持GET和POST，具体请求方式需要结合云市场API进行使用。

调用地址

从云市场API中获得，如墨迹天气API见下图：

APPCODE

您可以通过 APPCODE 的方式，实现到被调用接口的身份认证，获取访问相关 API 的调用权限。具体调用请查看阿里云相关文档。注意，阿里云文档要求调用格式为"APPCODE"+[半格空格]+[APPCODE]，我们这里只需要直接输入真正的APPCODE即可。正常情况下编码方式不需要变化。

编码

支持UTF-8或GBK编码，具体使用需要查看云市场对应API文档。

参数填写

参数的输入项取决于云市场对应API的请求参数。比如墨迹天气，需要cityId和token，则需要在输入框内手动填写。

变量参数

在参数编辑框中使用变量，需要使用{{}}将变量包起来。
内置了如下全局变量，以在参数编辑框及脚本节点中访问：

来自上个节点的输出数据：payload。支持使用payload.payload对象中的某个key来访问指定key的数据；
来自输入节点的数据：query。比如api输入节点的入参、设备触发节点的设备数据；支持使用query.参数名来访问指定数据；
来自指定节点的输出数据：node.节点ID。支持使用node.节点ID.节点输出对象中的某个key来访问指定key的数据。
示例

{
   "productKey": "{{payload:productKey}}",  // 上一个节点的输出为：{productKey: '值'}，取productKey的值
   "deviceName": "{{query.deviceName}}", // API输入节点的入参中定义了一个名称为deviceName的入参，取入参deviceName的值
   "pageNum": "{{node.node_1399591c0.pageNum}}" // 节点node_399591c0的输出为{pageNum: 10}，取pageNum的值
{
    "code": 0,
    "data": {
       "city": {
               "cityId": 35,
               "counname": "中国",
               "name": "塘沽区（现滨海新区）",
               "pname": "天津市",
               "timezone": "8"
           },
       "condition": {
               "condition": "晴",
               "humidity": "10",
               "icon": "0",
               "temp": "9",
               "updatetime": "2019-01-22 17:00:08",
               "windDir": "西北风",
               "windLevel": "3"
           }
       },
       "msg": "success",
       "rc": {
           "c": 0,
           "p": "success"
       }
   }
}

节点输出

下面为墨迹天气API的返回示例。具体返回值请查看对应API的帮助文档。