# 唉好忙 API 文檔
一,**前言**:
* 因為HTTP協議是開放的,可以任人調用。所以本次項目接口是不希望被隨意調用,就做了訪問權限的控制,認證是好的用戶,才允許調用API。
二,**其他事項**:
1. 用戶登錄成功將會返回一個 **access_token** ,該 **access_token** 需在請求頭中攜帶,否則將視為無權訪問。
2. **access_token** 具有過期時限,如果 **access_token**過期,可使用 **refresh_token** 請求刷新。
3. **access_token** 必須使用 **Bearer Token(Token 令牌)** 方式,使用該方式頭部會多一個 **authorization**。
三,**全局返回碼說明**:
* 調用接口時,可能獲得正確或錯誤的返回碼,請根據返回碼信息調試接口,排查錯誤。
| 返回碼 | 說明 |
| --- | --- |
| 200 | 請求成功 |
| 400 | 業務錯誤,具體參見 msg 錯誤信息 |
| 422 | 請求參數校驗失敗|
| 401 | 認證失敗,access_token已過期 ,請刷新 access_token|
| 403 | 認證失敗,refresh_token已過期 ,請重新登錄|