/blog-backend

A Restful Blog Mangement System Backend

Primary LanguagePython

A Restful Blog Mangement System

Backend Language Python2.7 Web Framework Flask Database Sqlite3

Dev Enviroment Set:

pip install -r requirements.txt

Init Datebase

python manage.py db init  # use sqlite3 Default

Apply Mode change to database

python manage.py db migrate
python manage.py db upgrade

Create Superuser

python manage.py create_superuser
# then type email and password

Run:

python manage.py runserver  # running on 127.0.0.1:5000 Default

TODO: -[x] blog、comment -[x] config db, port -[ ] user permssion -[ ] active user -[x] change password api -[ ] change email api -[ ] blog list optimise -[ ] image support -[ ] websockt message

Blog labels 字段

多个 label 以 "," 隔开。Model Label 的存在是

API:

所有 API 返回 JSON 格式数据

错误时返回 {"message": "", "code": 500}

Blogs

  1. list blogs

GET /api/blogs

Query Parameters

Name Type Required Default Description
limit int false 20 items per-page
offset int false 0

Response: 200

{
    "items": [
        {
            "title": "",
            "content": "",
            "category_id": 1,
            "user_id": ,
            "create_time": "2018-01-30 09:10:11",
            "published_time": "xx", # maybe null
            "view_count": 0,
            "good_count": 0 
        }
    ]
}
  1. read blog

GET /api/blogs/

Path Parameters

Name Type Required Default Description
id int true - blog id

Response 200

{
    "title": "",
    "content": "",
    "category_id": 1,
    "user_id": ,
    "create_time": "2018-01-30 09:10:11",
    "published_time": "xx", # maybe null
    "view_count": 0,
    "good_count": 0 
}
  1. create blog

POST /api/blogs

Body Parameters

Name Type Required Default Description
title string true - blog title
content string true -
category_id int true -

Req:

{
    "title": "",
    "content": "",
    "category_id": 1
}

Response: 201

{
    "title": "",
    "content": "",
    "category_id": 1,
    "user_id": ,
    "create_time": "2018-01-30 09:10:11",
    "published_time": "xx", # maybe null
    "view_count": 0,
    "good_count": 0 
}
  1. update blog

POST /api/blogs/

Name Type Required Default Description
title string false - blog title
content string false -
category_id int false -

可以只传要修改的字段

Req:

{
    "title": "",
    "content": "",
    "category_id": 1
}

Response 200

{
    "title": "",
    "content": "",
    "category_id": 1,
    "user_id": ,
    "create_time": "2018-01-30 09:10:11",
    "published_time": "xx", # maybe null
    "view_count": 0,
    "good_count": 0 
}
  1. delete blog

DELETE /api/blogs/

Path Parameters

Name Type Required Default Description
id int true - blog id

Response 200

Category

  1. List category

GET /api/category

Response 200

{
    "items": [
        {
            "id": 1,
            "name": "技术",
            "user_id": 1,
            "create_time": "2018-01-30 09:10:11"
        }
    ]
}
  1. Create Category

POST /api/category

Body Parameters

Name Type Required Default Description
name string true - categroy name

Request

{
    "name": "技术"
}

Response 201

{
    "id": 1,
    "name": "技术",
    "user_id": 1,
    "create_time": "2018-01-30 09:10:11"
}
  1. Update Category

I don't think it's a good idea to update the category

  1. Delete Category

DELETE /api/category/

Path Parameters

Name Type Required Default Description
id int true - category id

Label

  1. List labels

GET /api/labels

Response 200

{
    "items": [
        {
            "id": 1,
            "name": "python",
            "user_id": 1,
            "create_time": "2018-01-30 09:10:11"
        }
    ]
}
  1. Create Label

POST /api/labels

Body Parameters

Name Type Required Default Description
name string true - label name

req

{
    "name": "python"
}

Response 201

{
    "id": 1,
    "name": "python",
    "user_id": 1,
    "create_time": "2018-01-30 09:10:11"
}
  1. Delete Label

DELETE /api/labels/

Path Parameters

Name Type Required Default Description
id int true - label id

User

  1. List users

GET /api/users

Response 200

{
    "items": [
        {
            "id": 1,
            "name": "xxx",
            "age": 18,
            "gender": 0,
            "email": "xxx@xxx.com",
            "phone_number": 12345678,
            "description": "sssss",
            "avatar": "/xx/xxx/xx",
            "avatar_large": "/xx/xxx/xxx",
            "is_admin": false,
            "sign_up_time": "2017-12-30 10:50:00",
            "last_login_time":  "2017-12-30 10:50:00",
        }
    ]
}
  1. Create User

POST /api/users

Body Parameters

Name Type Required Default Description
name string true -
email string true -
password string true -
phone_number string true -
description string false -
gender int false - 0 male, 1 female
age int false -

req

{
    "name": "adam", # not Required 
    "email": "xxxx@xxx.com",
    "password": "123456",
    "gender": 1, # (0, male) (1, female) not Required 
    "age": 28   # not Required 
    "description": ""
}

Response 201

{
    "id": 1,
    "name": "xxx",
    "age": 18,
    "gender": 0,
    "email": "xxx@xxx.com",
    "phone_number": 12345678,
    "description": "sssss",
    "avatar": "/xx/xxx/xx",
    "avatar_large": "/xx/xxx/xxx",
    "is_admin": false,
    "sign_up_time": "2017-12-30 10:50:00",
    "last_login_time":  "2017-12-30 10:50:00",
}
  1. Update User

PATCH /api/users/update

Body Parameters

Name Type Required Default Description
phone_number string true -
description string false -
gender int false - 0 male, 1 female
birthday string false -

Request

{
    "gender": 1, # (0, male) (1, female) not Required 
    "age": 28   # not Required 
    "description": "",
    "avatar": ""
}

Response 200

{
    "id": 1,
    "name": "xxx",
    "age": 18,
    "gender": 0,
    "email": "xxx@xxx.com",
    "phone_number": 12345678,
    "description": "sssss",
    "avatar": "/xx/xxx/xx",
    "avatar_large": "/xx/xxx/xxx",
    "is_admin": false,
    "sign_up_time": "2017-12-30 10:50:00",
    "last_login_time":  "2017-12-30 10:50:00",
}
  1. Change Password

POST /api/users/change-password

Name Type Required Default Description
old_password string true -
new_password string true -

Request

{
    "old_password": "",
    "new_password": ""
}

logout after changed password

  1. Delete User

DELETE /api/users/

  1. Login

POST /api/users/login

Body Parameters

Name Type Required Default Description
email string true -
password string false -

Request

{
  "email": "xxxxx",
  "password": "xxx"
}

Response 200

{
    "id": 1,
    "name": "xxx",
    "age": 18,
    "gender": 0,
    "email": "xxx@xxx.com",
    "phone_number": 12345678,
    "description": "sssss",
    "avatar": "/xx/xxx/xx",
    "avatar_large": "/xx/xxx/xxx",
    "is_admin": false,
    "sign_up_time": "2017-12-30 10:50:00",
    "last_login_time":  "2017-12-30 10:50:00",
}
  1. Logout

GET /api/users/logout