2 token 介面#
2.1 通過使用者ID和密碼取普通使用者token#
POST /token/id
請求頭#
| 參數名稱 | 資料類型 | 必填 | 描述 |
|---|
| access-token | string | false | Token |
| app_id | string | true | 應用程式ID |
| group_id | int64 | false | 僅當access-token為管理員token時,可以設定此欄位,表示以此群ID的管理員身份來呼叫此介面 |
| user_id | int64 | false | 僅當access-token為管理員token時,可以設定此欄位,表示以此使用者ID的身份來呼叫此介面 |
請求體(Request Body)#
| 參數名稱 | 資料類型 | 必填 | 預設值 | 描述 |
|---|
| device_guid | string | false | | 設備ID, 如果設定,則回傳PushToken |
| password | string | true | | 密碼 |
| user_id | int64 | true | | 使用者ID,僅用於使用者ID登入 |
響應體#
● 200 響應資料格式:JSON
| 參數名稱 | 類型 | 描述 |
|---|
| code | int32 | 回傳碼,200是成功 |
| data | object | 結果資料 |
| ⇥ access_key_secret | string | 檔案密鑰 |
| ⇥ encrypt_type | int32 | 是否啟用加密連接 |
| ⇥ expire | int64 | 過期時間戳 |
| ⇥ public_key | string | 公鑰 |
| ⇥ push_token | string | 推播Token |
| ⇥ store_token | string | 檔案token |
| ⇥ token | string | 訪問token, 即呼叫API時的access-token |
| ⇥ user_id | int64 | 使用者ID |
| message | string | 錯誤信息,如果成功,該項為null |
介面描述#
2.2 通過使用者名/手機號/郵箱取普通使用者token#
POST /token/login
請求頭#
| 參數名稱 | 資料類型 | 必填 | 描述 |
|---|
| access-token | string | false | Token |
| app_id | string | true | 應用程式ID |
| group_id | int64 | false | 僅當access-token為管理員token時,可以設定此欄位,表示以此群ID的管理員身份來呼叫此介面 |
| user_id | int64 | false | 僅當access-token為管理員token時,可以設定此欄位,表示以此使用者ID的身份來呼叫此介面 |
請求體(Request Body)#
| 參數名稱 | 資料類型 | 必填 | 預設值 | 描述 |
|---|
| device_guid | string | false | | 設備ID, 如果設定,則回傳PushToken |
| login_name | string | true | | 登入名,可以是手機號,郵箱,使用者名 |
| password | string | true | | 密碼 |
響應體#
● 200 響應資料格式:JSON
| 參數名稱 | 類型 | 描述 |
|---|
| code | int32 | 回傳碼,200是成功 |
| data | object | 結果資料 |
| ⇥ access_key_secret | string | 檔案密鑰 |
| ⇥ encrypt_type | int32 | 是否啟用加密連接 |
| ⇥ expire | int64 | 過期時間戳 |
| ⇥ public_key | string | 公鑰 |
| ⇥ push_token | string | 推播Token |
| ⇥ store_token | string | 檔案token |
| ⇥ token | string | 訪問token, 即呼叫API時的access-token |
| ⇥ user_id | int64 | 使用者ID |
| message | string | 錯誤信息,如果成功,該項為null |
介面描述#
2.3 通過使用者名和密碼取普通使用者token#
POST /token/user
請求頭#
| 參數名稱 | 資料類型 | 必填 | 描述 |
|---|
| access-token | string | false | Token |
| app_id | string | true | 應用程式ID |
| group_id | int64 | false | 僅當access-token為管理員token時,可以設定此欄位,表示以此群ID的管理員身份來呼叫此介面 |
| user_id | int64 | false | 僅當access-token為管理員token時,可以設定此欄位,表示以此使用者ID的身份來呼叫此介面 |
請求體(Request Body)#
| 參數名稱 | 資料類型 | 必填 | 預設值 | 描述 |
|---|
| device_guid | string | false | | 設備ID, 如果設定,則回傳PushToken |
| name | string | true | | 使用者名,僅用於使用者名登入 |
| password | string | true | | 密碼 |
響應體#
● 200 響應資料格式:JSON
| 參數名稱 | 類型 | 描述 |
|---|
| code | int32 | 回傳碼,200是成功 |
| data | object | 結果資料 |
| ⇥ access_key_secret | string | 檔案密鑰 |
| ⇥ encrypt_type | int32 | 是否啟用加密連接 |
| ⇥ expire | int64 | 過期時間戳 |
| ⇥ public_key | string | 公鑰 |
| ⇥ push_token | string | 推播Token |
| ⇥ store_token | string | 檔案token |
| ⇥ token | string | 訪問token, 即呼叫API時的access-token |
| ⇥ user_id | int64 | 使用者ID |
| message | string | 錯誤信息,如果成功,該項為null |
介面描述#