{extend name="common:base" /} {block name="title"}Upload API Document - {$config.site_name}{/block} {block name="main"}

## 1. 获取Token

功能 | 接口
请求方式 | POST
URL | {$domain}/api/token

#### 请求参数

参数名称 | 类型 | 是否必须 | 说明
email | String | 是 | 邮箱
password | String | 是 | 账号密码
format | String | 否 | 返回数据格式，可选json、xml、jsonp，默认json

#### 返回数据说明

参数名称 | 类型 | 实例值 | 说明
code | Number | 200 | 状态码，成功返回200，失败返回500
msg | String | success | 提示信息
time | Number | 1544176295 | 响应时间戳
data | array|object | {"token": "8961576c9090ef0902c4b89406f8d557"} | 获取的token数据

## 2. 图片上传

功能 | 接口
请求方式 | POST
URL | {$domain}/api/upload

#### 请求参数

参数名称 | 类型 | 是否必须 | 说明
image | File | 是 | 表单名称
format | String | 否 | 返回数据格式，可选json、xml、jsonp，默认json

注意：请求时header如果有参数 token，接口则认证该token，上传的图片也是在该token用户下，否则为游客上传。

#### 返回数据说明

参数名称 | 类型 | 实例值 | 说明
code | Number | 200 | 状态码，成功返回200，失败返回500
msg | String | success | 提示信息
time | Number | 1544176295 | 响应时间戳
data | array|object |
    {
      "name": "9B7BCFBD05891B2D42187F126887777A.jpg",
      "url": "http://域名/2018/12/08/5c0b519f44701.jpg"
    }
| 获取的token数据

#### 上传示例

    POST /api/upload HTTP/1.1
    Host: {$domain}

    Connection: keep-alive
    Content-Length: 57398
    Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryx2mqINKHVPJ8yMdK

    ------WebKitFormBoundaryx2mqINKHVPJ8yMdK
    Content-Disposition: form-data; name="image"; filename="test.png"
    Content-Type: image/png

#### 响应错误示例

    {
      "code": 500,
      "msg": "管理员关闭了游客上传！",
      "data": null,
      "time": 1544245931
    }

{/block}