接口调用说明.md

智能问答接口

接口描述

• 该接口对知识库的相关知识提问做相应回答。

请求URL

• h134:14000/askFromWeChat?question=银团贷款业务借款人需要签署什么？&project=xxxxx

请求方式

• POST/GET

Header

暂无特殊要求

参数

参数名	必选	类型	说明
question	是	string	对于相关知识点提出的问题
project	是	string	所在工程库 目前有xz(小招)　sk(社科)　all(所有库　，此部分未完成，预留接口)

参数示例

question=银团贷款业务借款人需要签署什么？&project=xz

返回示例

{
    "title":"银团贷款",
	"type":"Graph",
	"data":"是由获准经营贷款业务的一家或数家银行牵头，多家银行与非银行金融机构参加而组成的银行集团（Banking Group）采用同一贷款协议，按商定的期限和条件向同一借款人提供融资的贷款方式。国际银团是由不同国家的多家银行组成的银行集团。"
}

说明：
type为所有调用的返回类型,有Graph,Turing,law
title为type是Law时候才会有的字段
data为整理返回的展示结果集

---

# **知识库操作平台接口**

接口描述

• 该接口主要是为相关专业人士能够直接操作图谱与前台对接的增删改查的API。
• 根据相应功能传入参入进行不同深度的DFS或BFS将相关结果处理后返回给前台。

请求URL

• http://h134:14000/graphOp

请求方式

• POST/GET

Header

暂无特殊要求

参数

请求参数为一个整体的Json请求体,整个Json中需包含以下字段参数

参数名	必选	类型	说明
type	是	string	对图谱操作调用类型，包括 checkByName(通过名称查询) checkByIndex(通过索引查询) checkById(通过节点id查询) addNode(新增节点) deleteNode(删除节点) changeNode(修改节点) addEdge(新增边) changeEdge(修改边) deleteEdge(删除边) addNodeEdge(新增边和终点) queryNodeDetail(查看点的详情) queryEdgeDetail(查看边的详情) getEdgeAllName(查询边的所有名称)
project	是	string	所用的知识库图谱 目前有 ytdkyw(银团贷款业务) shkx(社会科学知识库) licom(上市公司分析) down_2014(2014上市公司担保分析)
info.node	否	Json	点相关信息，请求type为点相关则必须填写内部相关信息
info.edge	否	Json	边相关信息，请求type为边相关则必须填写内部相关信息
info.layer	是	string	搜索的深度数量
info.node.name	否	string	节点名称
info.node.id	否	string	删改查时候才会用到，增时为系统自动生成
info.node.root	否	string	节点所在子图
info.node.type	否	string	节点类型
info.node.label	否	string	节点所在的标签
info.node.content	否	string	节点内容，为Json转成的string
info.edge.id	否	string	边的图上id，系统自动生成
info.edge.from	否	string	边的起始点id
info.edge.to	否	string	边的终点id
info.edge.relationship	否	string	边所在的关系标签
info.edge.name	否	string	边的名称

参数示例

• data= json字符串
• json字符串示例如下：

 {"type":"deleteEdge",
 "project":"",
 "info":{
    	 "node":{
         "name":"",
               "id":"",
               "root":"",
                "type":"",
                "label":"edge",
                "content":""
		},
		"edge":{
		   "id":"",
        "from":"",
        "to":"",
        "relationship":"",
        "name":""
	},
		"layer":"2"
	}
		}

说明：
请求参数名为data,后面为一个完整的json的String类型

返回示例

result:

{
    "nodeTypeName":[
        {
            "type_cn":"描述",
            "type_en":"desc"
        },
        {
            "type_cn":"别名",
            "type_en":"aliases"
        },
        {
            "type_cn":"公司",
            "type_en":"com"
        }
    ],
    "nodes":[
        {
            "identity":"46bf30c1-14fc-4bbe-8727-ac39a4b65a72",
            "root":"wiki数据",
            "name":"地球",
            "name_length":2,
            "id":"5443432",
            "label":"wikidata_label",
            "type":"com",
            "content":""
        },
        {
            "identity":"b245c7b2-6946-4a45-bf8c-4292299d9c17",
            "root":"wiki数据",
            "name":"Sol d",
            "name_length":5,
            "id":"5443444",
            "label":"wikidata_label",
            "type":"aliases",
            "content":""
        }
    ],
    "center":"5443432",
    "edges":[
        {
            "root":"wiki数据",
            "name":"aliases",
            "from":"5443432",
            "name_length":7,
            "to":"5443442",
            "id":"534328",
            "relationship":"wikidata_relationship"
        },
        {
            "root":"wiki数据",
            "name":"aliases",
            "from":"5443432",
            "name_length":7,
            "to":"5443437",
            "id":"534323",
            "relationship":"wikidata_relationship"
        }
    ]
}

说明：

字段名	类型	说明
nodeTypeName	JsonArray	结果集合中点的类型集合
nodes	JsonArray	结果集中所有的点信息
edges	JsonArray	结果集中所有的边信息
center	String	结果集子图的中心点的id
nodeTypeName.type_cn	String	节点类型中文描述
nodeTypeName.type_en	String	节点类型英文描述
identity	String	外部定义的唯一表示，用于插入时做标示使用
root	String	所在子项目的名称，主要只是要求任务的名称
name	String	具体名称
name_length	String	名称长度
id	String	neo4j产生的内部唯一标示
label	String	节点所在标签
content	String	自身其他信息，但是不用于业务中
from	String	边起始id
to	String	边终点id
relationship	String	边所在的关系标签

---