使用数据服务发布的API（POST x-www-form-urlencoded请求）

1.1 版本

1.2 应用场景

本文介绍如何将 FineDataLink 数据服务发布API 中请求方式为 POST（x-www-form-urlencoded）类型的接口数据取出。

注：若用户需要使用自己系统中的 API 进行取数，可参见：API取数概述

已经发布的 API 接口说明如下：

请求说明：

POST 请求body参数：

请求示例：

注：此处的 area 为 发布API  中设置的自定义参数。

返回值参数：

响应值示例：

{
    "data": [
        {
            "运货商": null,
            "货主地区": "华中",
            "货主邮政编码": "214000",
            "应付金额": null,
            "雇员ID": "214001",
            "备注": null,
            "到货日期": "2023-02-22",
            "货主名称": "林小姐",
            "订购日期": "2023-02-27",
            "货主城市": null,
            "货主国家": "中国",
            "订单ID": "214001",
            "货主地址": null
        }
    ],
       "pageSize": 10,
        "rowCount": 10,
        "message": "success",
        "totalCount": 85,
        "pageNum": 1
}

错误返回码：

详情参见本文第四节。

3.1 获取API地址

首先在API列表界面选择需要使用的API，然后在已授权应用处复制路径，获取到 API 完整路径地址，例如：http://192.168.5.175:8089/webroot/service/publish/service/publish/80a0d8d0-98fa-4818-b25b-00d77c76e6c5/demo1，如下图所示：

3.2 获取 API 鉴权

若用户使用了鉴权，则需要在「应用」中复制 APPCode，如下图所示：

注：如果开启了黑白名单，需要保证使用 API 的环境与发布 API 环境之间信息能互通。

3.3 设置 API 基本信息

使用任意取数软件，选择POST请求方式，输入复制的API链接，选择「Authorization」，勾选认证类型为「API Key」，输入Key：Authorization，value ：AppCode f99d314a-41fc-4d5b-865d-966b1cee74c1，选择 Add to 为 Headers，如下图所示：如下图所示：

注1：复制的链接默认为IP:端口/webroot 路径，如果用户的FineDataLink做过Tomcat下通过IP直接访问系统，则需要给复制的url去掉webroot。

注2：参数值格式为：APPCode+空格+APPCode值，此处的 APPCode 为示例。

然后在Body 中选择「x-www-form-urlencoded」，输入键值数据，如下图所示：

示例取出「为NULL」的数据，因此自定义参数 area 的 value 直接写成 NULL，将 pageSize 设置为 20，也就是每页数据限制为 20 条，从第一个开始取数，查看返回值中，每页 20 条数据计算总页数为多少。

点击 send 后返回值如下图所示：

调用返回值说明详情参见：接口响应码说明