Ghost 的 api 的整理

前缀一般为 /ghost/api/v0.1/

请求分为两种，一种是公开的，一种是私有的，公开的接口可以直接访问，但是私有的接口需要添加一些表示登陆的凭着，登陆请求头如下

登陆头部校验

登陆请求

请求路径: /authentication/token
请求类型: post
头部:

请求体(body):

发送重置密码邮件

请求路径: /authentication/passwordreset
请求类型: post

请求体(body):

请求体被放置在passwordreset中，passwordreset是一个数组，但是数组中只有一个元素，元素的字段如下

重置密码

请求路径: /authentication/passwordreset
请求类型: put

请求体(body):

请求体被放置在passwordreset中，passwordreset是一个数组，但是数组中只有一个元素，元素的字段如下

接受邀请

请求路径: /authentication/invitation
请求类型: post

请求体(body):

请求体被放置在invitation中，invitation是一个数组，但是数组中只有一个元素，元素的字段如下

查看邀请状态

请求路径: /authentication/invitation
请求类型: get

query:

查看是否激活了用户体系

请求路径: /authentication/setup
请求类型: get

返回例子：

{
  "setup": [
    {
      "status": true
    }
  ]
}

查看设置

请求路径: /authentication/configuration
请求类型: get
请求头：请查看私有权限api头部规范

返回例子：

{
  "configuration": [{
    "key": "fileStorage",
    "value": true
  }, {
    "key": "publicAPI",
    "value": false
  }, {
    "key": "apps",
    "value": false
  }, {
    "key": "version",
    "value": "0.7.4"
  }, {
    "key": "environment",
    "value": "production"
  }, {
    "key": "database",
    "value": "mysql"
  }, {
    "key": "mail"
  }, {
    "key": "blogUrl",
    "value": ""
  }, {
    "key": "blogTitle",
    "value": ""
  }, {
    "key": "routeKeywords",
    "value": ""
  }, {
    "key": "storage",
    "value": ""
  }]
}

查看某项设置

请求路径: /authentication/configuration/:key
请求类型: get
请求头：请查看私有权限api头部规范

参数

返回例子：

{
  "configuration": [{
    "key": "fileStorage",
    "value": true
  }]
}

获取所有的博客

请求路径: /posts
请求类型: get

query:

创建博客

请求路径: /posts
请求类型: post
请求头：请查看私有权限api头部规范

query:

请求体，放置在posts字段中，posts是一个数组，数据放置在第一个对象中：

获取博客信息

请求路径: /posts/:id
请求类型: get
请求头：请查看私有权限api头部规范

params:

更新博客

请求路径: /posts
请求类型: put
请求头：请查看私有权限api头部规范
请求体：

和创建博客相同，多加上一个id字段

删除博客

请求路径: /posts/:id
请求类型: delete
请求头：请查看私有权限api头部规范

获取所有存储在数据库中的设置

请求路径: /settings
请求类型: get
请求头：请查看私有权限api头部规范

获取存储在数据库中的某个设置

请求路径: /settings/:key
请求类型: get
请求头：请查看私有权限api头部规范

更新存储在数据库中的某个设置

请求路径: /settings
请求类型: put
请求头：请查看私有权限api头部规范
请求体：

获取所有用户

请求路径: /users
请求类型: get
请求头：请查看私有权限api头部规范
query:

获取某个用户

请求路径: /users/:id
请求类型: get
请求头：请查看私有权限api头部规范
params:

通过邮箱获取某个用户

请求路径: /users/email/:email
请求类型: get
请求头：请查看私有权限api头部规范
params:

修改密码

请求路径: /users/password
请求类型: put
请求头：请查看私有权限api头部规范
请求体:

字段都放置在password中，放置其对应数组的第一个对象

修改用户信息

请求路径: /users/:id
请求类型: put
请求头：请查看私有权限api头部规范
请求体:

字段都放置在users中，放置其对应数组的第一个对象，对象为user的普遍对象，可查看查询user的返回

创建用户

请求路径: /users
请求类型: post
请求头：请查看私有权限api头部规范
请求体: 待补充...

删除用户

请求路径: /users/:id
请求类型: delete
请求头：请查看私有权限api头部规范

修改博客所属

请求路径: /users/owner
请求类型: put
请求头：请查看私有权限api头部规范

请求体：

待补全...

获取所有的角色

请求路径: /roles
请求类型: get
请求头：请查看私有权限api头部规范

获取登陆的client信息

用于登陆时使用，默认的slug有ghost-frontend，ghost-admin

请求路径: /clients/slug/:slug
请求类型: get
请求头：请查看私有权限api头部规范

获取主题

请求路径: /themes
请求类型: get
请求头：请查看私有权限api头部规范

获取所有标签

请求路径: /tags
请求类型: get
请求头：请查看私有权限api头部规范

通过id获取某个标签

请求路径: /tags/:id
请求类型: get
请求头：请查看私有权限api头部规范

通过slug来获取某个标签

请求路径: /tags/slug/:slug
请求类型: get
请求头：请查看私有权限api头部规范

创建tag

请求路径: /tags
请求类型: post
请求头：请查看私有权限api头部规范
请求体:

外层字段放置在tags中，数据放置在tags的第一个元素中

更新tag

请求路径: /tags/:id
请求类型: put
请求头：请查看私有权限api头部规范
请求体:

外层字段放置在tags中，数据放置在tags的第一个元素中

删除标签

请求路径: /tags/:id
请求类型: delete
请求头：请查看私有权限api头部规范

上传图片

请求路径: /uploads
请求类型: post
请求头：请查看私有权限api头部规范

请求体（mutipart）:

图片的字段名 uploadimage

get /slugs/:type/:name public

get /notifications private

post /notifications private

delete /notifications/:id private

post /mail private post /mail/test private

post /authentication/setup private put /authentication/setup private