source 接口

查询项目的 source 信息

GET /upload/project/:project/user/:user

  1. {
  2.     "ret": true,
  3.     "data": "success"
  4. }

查询对应项目在 source 中的最高版本

GET /upload/version/project/:project/branch/:branch/path/:path

  1. {
  2.     "ret": true,
  3.     "data": {
  4.         "version": "1.0.0"
  5.     }
  6. }

上传图标到 source

POST /upload/project

  • req:
  1. {
  2.     "username": "changquan.fang",
  3.     "project": "demo",
  4.     "path": "fonts/",
  5.     "branch": "master",
  6.     "version": "0.1.11"
  7. }
  • res:
  1. {
  2.     "ret": true,
  3.     "data": {
  4.         "sourceUrl": "xxx/xxx/fonts/"
  5.     }
  6. }
  7. sourceUrl 表述上传 source 后生成的路径信息

查询下载接口

查询项目信息

  • 包括项目 id、名字、版本、负责人、图标详情和字体下载地址
  • 校验是否生成过版本，如果没有，则返回项目基本信息和相应的未生成过版本的提示
  • 校验当前项目是否有图标变化，如果有图标变化，则更新 has_change 状态为 true 并返回相应的存在图标变更的提示

  • 否则返回该项目对应版本的信息
    GET /api/projects/name/:name

  • res

  1. {
  2.     "res": true,
  3.     "data": {
  4.         "id": 463,
  5.         "name": "flight_adr_icon",
  6.         "info": "机票用户产品部安卓图标",
  7.         "owner": "qianru.wang",
  8.         "latest_version": "0.3.16",
  9.         "latest_info": {
  10.             "version": "0.3.16",
  11.             "icons": [
  12.                 {
  13.                     "id": 91,
  14.                     "name": "定位",
  15.                     "code": 61525
  16.                 },
  17.                 {图标信息2},
  18.                 ...
  19.             ],
  20.             "download": {
  21.                 "eot": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/eot/version/0.3.16",
  22.                 "svg": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/svg/version/0.3.16",
  23.                 "ttf": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/ttf/version/0.3.16",
  24.                 "woff": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/woff/version/0.3.16"
  25.             }
  27.         },
  28.         "has_change": false, // 项目是否有图标变更
  29.         "versions": ["0.0.1", "0.1.0"],
  30.         "message": ""
  31.     }
  32. }

根据版本查询项目信息

  • 包括项目 id、名字、版本、负责人、图标详情和字体下载地址

  • 根据指定的版本，查询项目信息
    GET /api/projects/name/:name/:version

  • res

  1. {
  2.     "res": true,
  3.     "data": {
  4.         "id": 463,
  5.         "name": "flight_adr_icon",
  6.         "info": "机票用户产品部安卓图标",
  7.         "owner": "qianru.wang",
  8.         "version": "0.3.16",
  9.         "icons": [
  10.             {
  11.                 "id": 91,
  12.                 "name": "定位",
  13.                 "code": 61525
  14.             },
  15.             {图标信息2},
  16.             ...
  17.         ],
  18.         "download": {
  19.             "eot": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/eot/version/0.3.16",
  20.             "svg": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/svg/version/0.3.16",
  21.             "ttf": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/ttf/version/0.3.16",
  22.             "woff": "http://iconfont.corp.qunar.com/api/download/name/flight_adr_icon/type/woff/version/0.3.16"
  23.         }，
  24.         "message": ""
  25.     }
  26. }

下载地址

  • 根据项目名称、字体格式和项目版本下载对应字体文件，当版本不是最新版，无法下载

  • 正常直接下载文件，无法下载时返回错误信息
    GET /api/download/name/:name/type/:type/version/:version

  • res

  1. {
  2.     "res": false,
  3.     "status": 500,
  4.     "message": "当前0.3.15版本已过期，不可下载"
  5. }