API

SMS Authentication

1. 前端呼叫 Firebase Auth API 讓使用者使用 sms 登入
2. 前端 callback 呼叫 getIdToken 取得 id_token
3. token 參數用 POST 呼叫時帶入：/api/users/token_auth/
4. 成功的話取得 jwt token：

{'jwt': 'MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEoBUyo8CQAFPeYPvv78ylh5MwFZjTCLQeb042TjiMJxG+9DLFmRSMlBQ9T/RsLLc+PmpB1+7yPAR+oR5gZn3kJQ=='}

5. 可以在一定時間內用此 jwt token 存取，呼叫時把 token 放到 header：

Authorization: JWT <token>

6. exceptions:

401 Unauthenticated: 請重新認證
400 Bad Request: 請使用國碼為+886的手機進行驗證
400 Bad Request: 您的手機號碼已超出每日服務驗證次數限制，請聯絡本團隊為您處理

Model Base Restful API

1. GET: Region list /api/regions/
2. GET: Type list /api/types/
3. POST: File create /api/files/temp/ 需要JWT token

{
    "case_uuid": "54eaa9c1-d4de-4717-8738-40991a6cef06",
    "file": "/D:/img/howfun.png",
}

回傳格式：

{
    "id": "2c92077f-435b-4a9b-b2ee-5b91b20b22d6",
    "url": "/media/tempfile/54eaa9c1-d4de-4717-8738-40991a6cef06/howfun.png",
    "case_uuid": "54eaa9c1-d4de-4717-8738-40991a6cef06",
    "file": "54eaa9c1-d4de-4717-8738-40991a6cef06/howfun.png",
    "file_name": "howfun.png",
    "upload_time": "2019-01-19T10:27:43.617640+08:00"
}

錯誤訊息：

400 Bad Request: 相同檔名的檔案已經存在
400 Bad Request: 單一檔案大小超出限制
400 Bad Request: 單一案件的上傳檔案大小超出限制
400 Bad Request: 您的手機號碼已超出上傳限制，請聯絡本團隊為您處理

4. DELETE: File delete /api/files/temp/fileid 需要JWT token

/api/files/temp/2c92077f-435b-4a9b-b2ee-5b91b20b22d6

5. GET: Case list /api/cases/vuetable/，配合前端vuetable-2 Server side render

Query參數：

query: 搜尋參數
limit: 單頁筆數
sort: 排序欄位
ascending: 順逆排
page： 第幾頁

回傳格式：

{
    "data": [
        {
            "number": "000001",
            "date": "2018/01/01",
            "title": "上班時段計程車過多",
            "content": "test",
            "location": "台北市松山區復興北路",
            "type": '交通運輸',
            "state": "處理中",
        },
    ],
    "count": 100,
}

6. GET: Case detail /api/cases/

回傳格式：

{
    "id": 1,
    "number": "000001",
    "create_time": "2019年1月2日 15:07",
    "title": "上班時段計程車過多",
    "content": "小弟我是台北市民，常常看到很多路上的小黃為了載客硬切慢車道差點造成意外，到了深夜路上的小黃更是快比自用車還多，請問大家會不會覺得台北市的計程車太多了呀？",
    "location": "台北市松山區復興北路",
    "type": "交通運輸",
    "state": "已結案",
    "arranges": [
        {
            "title": "發文交通部",
            "content": "<p>面對UBER競爭，計程車司機的日子是越來越難過？交通部每2年進行1次計程車營運狀況調查近日公布，去年專職計程車駕駛每月平均收入為4萬6045元，較104減少1583元；但營業支出卻微幅增加266元。交通部表示，UBER於102年就進入台灣，104年專職計程車駕駛收入有成長2333元，這個統計數字無法呈現是否是受UBER競爭所致，且抽樣統計時約有3%誤差，相差千餘元不一定代表駕駛所得真的下跌</p>",
            "arrange_time": "2018年1月12日 22:10"
        },
    ]
}

7. POST: Case create /api/cases/ 需要JWT token

{
    "uuid": "54eaa9c1-d4de-4717-8738-40991a6cef06",
    "title": "上班時段計程車過多",
    "content": "test",
    "location": "台北市松山區復興北路",
    "username": "王大明",
    ~~"mobile": "0972505938",~~
    "email": "travishen.tw@gmail.com",
    "address": "台北市松山區南路3段38號7樓",
    "type": 1,
    "region": 1
}