第三方标准接口说明

简介

什么是第三方数据接口?

所谓第三方数据接口就是可以为访客提供数据支持的其他的业务数据的来源。广泛用于第三方业务系统数据查询和数据跟踪需求。如积分查询等等。

功能介绍

在机器人的问答业务中,常常遇到需要调用其他业务是同才能完成的问答,如通过产品编号产寻产品,根据业务编号查询办事业务进度等,如果对接身份认证系统,那么可以查询的业务更多,如订单查询,积分查询等等。 当用户输入特定格式的问题时,系统可以通过查询第三方接口的形式回答用户的问题。机器人目前支持http接口的调用方式,数据内容采用json格式标准。

过程概述

用户获取第三方数据的过程示例

例1(未对接身份认证):根据申报人查询办事进度

效果图:

  1. 用户在聊天客户端发送 比如:申报人羊洪
  2. 机器人收到请求,理解问题判断后 调用第三方接口
  3. 机器人发出请求到第三方接口并获取json数据
  4. 解析json数据,返回结果给用户

例2(对接接身份认证):查询用户积分效果图

  1. 用户在微信客户端发送 比如:我的积分
  2. 机器人收到请求,验证身份是否合法,理解问题,调用积分查询接口
  3. 机器人发出请求到第三方接口并获取json数据
  4. 解析json数据,返回结果给用户

第三方标准接口对接

  1. 数据接口

    请求地址:http://XXX/XXXXX (第三方提供,需外网可以访问)
    接口说明:用户请求特定问题的时候调用的第三方的数据源的接口
    请求类型:POST/GET
    请求参数:

    名称 类型 可选 说明
    -- 整型 --

    返回字段说明:

    字段名称 类型 字段说明
    status 整型 0正确 其他返回值错误
    result 字符串 返回数据查询的结果,结果可以是字符串也可以是html代码片段(自己调节样式),机器人直接展示给前端用户。

    返回数据示例:

    1. {
    2.     "status":0,
    3.     "result" : "<table width="100%" border="0" cellspacing="0" cellpadding="0">
    4.                     <tbody>
    5.                        <tr>
    6.                          <td>
    7.                          .....
    8.                          <td>许可办结</td>
    9.                        </tr>
    10.                    </tbody>
    11.                 </table>"
    12. }

如何配置第三方接口

  1. 登陆系统 找到 平台对接—》添加第三方接口

  2. 直接在客户端发送”测试请求”即可

寻求技术支持