coco/public-six-degrees

Public Six Degrees API镜像

镜像概述

该镜像封装了Public Six Degrees API，为“六度关系”应用提供公共接口，用于检索最常被提及的人物及关联人物信息。API通过连接Neo4j数据库获取所需数据。

核心功能

• 关联人物查询：通过/sixdegrees/connectedPeople端点获取指定人物的关联人物，支持日期范围、最小连接数等参数过滤。
• 高频提及人物查询：通过/sixdegrees/mostMentionedPeople端点获取指定时期内最常被提及的人物列表。
• 管理接口：提供/__health、/__gtg等健康检查及构建信息查询端点。

使用场景

• 媒体数据分析：统计特定时期人物提及频率与关联网络。
• 人物关系研究：探索不同人物间的关联路径。

配置说明

运行镜像时需指定Neo4j数据库地址，参数为--neo-url。

部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 docker.xuanyuan.run/coco/public-six-degrees --neo-url=neo4j://your-neo4j-host:7687

接口示例

查询关联人物

GET /sixdegrees/connectedPeople?uuid=dc278df2-1c8b-3e44-8ca8-5d255f75f737&fromDate=2016-01-01&toDate=2016-05-17&limit=2

返回结果示例：

json
[{
    "person": {
        "id": "http://api.ft.com/things/9185a2a9-1545-302b-9a16-c63986b67be3",
        "apiUrl": "http://api.ft.com/people/9185a2a9-1545-302b-9a16-c63986b67be3",
        "prefLabel": "Boris Johnson"
    },
    "count": 162,
    "content": [{
        "id": "40b38230-c101-11e5-9fdb-87b8d15baec2",
        "apiUrl": "http://api.ft.com/content/40b38230-c101-11e5-9fdb-87b8d15baec2",
        "title": "Heathrow decision put off until after EU referendum"
    }, {
        "id": "6db05608-18e7-11e6-b197-a4af20d5575e",
        "apiUrl": "http://api.ft.com/content/6db05608-18e7-11e6-b197-a4af20d5575e",
        "title": "Do we still need to build a third runway at Heathrow?"
    }, {
        "id": "81665806-e23b-11e5-9217-6ae3733a2cd1",
        "apiUrl": "http://api.ft.com/content/81665806-e23b-11e5-9217-6ae3733a2cd1",
        "title": "Osborne plays it safe over pensions"
    }]
}, {
    "person": {
        "id": "http://api.ft.com/things/9421d9ee-7e0f-3f7c-8adc-ded83fabdb92",
        "apiUrl": "http://api.ft.com/people/9421d9ee-7e0f-3f7c-8adc-ded83fabdb92",
        "prefLabel": "George Gideon Oliver Osborne"
    },
    "count": 136,
    "content": [{
        "id": "40b38230-c101-11e5-9fdb-87b8d15baec2",
        "apiUrl": "http://api.ft.com/content/40b38230-c101-11e5-9fdb-87b8d15baec2",
        "title": "Heathrow decision put off until after EU referendum"
    }, {
        "id": "6db05608-18e7-11e6-b197-a4af20d5575e",
        "apiUrl": "http://api.ft.com/content/6db05608-18e7-11e6-b197-a4af20d5575e",
        "title": "Do we still need to build a third runway at Heathrow?"
    }, {
        "id": "ceeaecdc-e12c-11e5-9217-6ae3733a2cd1",
        "apiUrl": "http://api.ft.com/content/ceeaecdc-e12c-11e5-9217-6ae3733a2cd1",
        "title": "Minister takes on Treasury over pension Isa"
    }]
}]

查询高频提及人物

GET /sixdegrees/mostMentionedPeople?fromDate=2016-01-01&toDate=2016-01-02&limit=5

返回结果示例：

json
[{
    "id": "[***]",
    "prefLabel": "David William Donald Cameron"
}, {
    "id": "[***]",
    "prefLabel": "Hillary Rodham Clinton"
}, {
    "id": "[***]",
    "prefLabel": "John Ellis Bush"
}, {
    "id": "[***]",
    "prefLabel": "Joachim Herrmann"
}, {