如何使用Flask提供HTML和JSON内容?

时间:2016-04-12 15:38:03

标签: python json templates flask api-design

我想设置一个同时具有GUI和API组件的Flask应用。所以这是一个检索组列表的简单示例:

def get_groups():
    groups = db.session.query(SgmGroup.group_name).order_by(SgmGroup.group_name).all()
    return [group.group_name for group in groups]

@app.route('/list')
def group_list():
    groups_list = get_groups()
    return render_template('groups.html', groups=groups_list)

到目前为止一切都很好 - 这将为用户提供HTML用户列表,可能是表格或其他一些不错的GUI格式。

但我也想为API请求提供JSON内容:

@app.route('/api/list')
def api_group_list():
    groups_list = get_groups()
    return jsonify({'groups': group_list})

这有效 - 但这是个好主意吗?我有两个问题:

1)当我有两种不同类型的内容时,这是使用Flask的合适方式吗?为网络浏览器(HTML)创建一个/endpoint网址,并使用相同的/api/endpoint网址来处理API请求(JSON)?

2)或者我应该将这两个端点合并为一个函数吗?这似乎更整洁,但是如何确定用户访问的端点?也就是说,下面的伪代码可以完成吗?

@app.route('/list')
@app.route('/api/list')
def group_list():
    groups_list = get_groups()

    if <user arrived here via the /list endpoint>:
        return render_template('groups.html', groups=groups_list)

    elif <user arrived here via the /api/list endpoint>:
        return jsonify({'groups': group_list})

2 个答案:

答案 0 :(得分:2)

回答你的第二个问题:

from flask import request

@app.route('/')
@app.route('/json')
def index():
    if request.path == '/json':
        return {}
    return render_template('index.html')

文档参考为here

答案 1 :(得分:0)

您还可以按方法将请求拆分为不同的功能,如:

@app.route('/', methods=['GET', 'POST'])
def index():
    if request.method == 'POST':
        return {}
    else:
        return render_template('index.html')

出于项目结构的原因,我建议将路由拆分为不同文件中的api和模板。

project
├── app
|    ├── views.py
|    └── api.py
└──.....