HTTP接口标准

参考样例

数据格式确认

image.png

当你需要返回的值，只用一个数值即可表达的时候，就选择用Number类型。

第一层的数据结构

{
  "code": 404,
  "message": "文章分类不存在",
  "time": "2022-01-12 12:00:00",
  "data": {}
}

模板文件

xxxx接口

URL

• http://ip:port/app_board_clustering

请求格式

POST方式，须带上http请求头

http请求头

HTTP header	必选	说明
Content-Type	是	application/json

数据格式

参数名	必选	类型	说明
items	是	Array of Item(Object)
move	否	Number

Item(Object)数据格式

参数名	必选	类型	说明
item_id	是	String
type	否	String

返回值

数据格式
请求成功则返回json格式串，格式如下

参数名	类型	说明
code	Integer	0为成功，-1为失败
data	Array of SItem(Object)	经过排重策略后的热榜排序结果，已调整为新的顺序
info	String	返回值说明

Item(Object)数据格式

参数名	必选	类型	说明
item_id	String	热榜内容唯一id
type	String	内容类型（pictext、video）
new_rank	Number	调整后次序位置，0表示列表首项
cluster_id	String	聚簇的id，相同的id表示同一簇，从0累加

返回样例

{
    'data': [
        {
            'coin_pair': 'btc-usd',
            'investing_signal': {
                '1 分钟': '强力买入',
                '5 分钟': '强力买入',
                '15 分钟': '强力买入',
                '30 分钟': '强力买入',
                '每小时': '强力买入',
                '5 小时': '强力买入',
                '每日': '强力买入',
                '每周': '卖出',
                '每月': '强力卖出'
            },
            'cur_price': '37,844.0',
            'today_chg': '+2.81%',
            'price_low': '36,197.0',
            'price_high': '38,055.0'
        },
        {
           'coin_pair': 'eth-usd',
            'investing_signal': {
                '5 分钟': '买入',
                '15 分钟': '买入',
                '30 分钟': '强力买入',
                '每小时': '强力买入',
                '5 小时': '强力买入',
                '每日': '买入',
                '每周': '强力卖出',
                '每月': '强力卖出'
            },
            'cur_price': '2,555.78',
            'today_chg': '+5.46%',
            'price_low': '2,357.88',
            'price_high': '2,585.89'
        }
    ],
    'time': '2022-01-29 15:33:18',
        'message': 'OK',
    'code': 0
}