登入

描述

你可以使用此 API 獲取一個 token,把它放到自定義 HTTP 頭部 edge-token 中可以呼叫其他登入後才能呼叫的介面。 edge-token 的有效期預設是 8 小時;最長有效期是 31 天。

URI

POST /admin-api/user/login

JSON Body 引數

{
    "username":"username",
    "password":"password",
    "remember": false,      # 當 remember 引數為 true 時, edge-token 有效期為 31 天。
    "plugin":"Builtin"
}

請求示例

curl  http://{admin-site}/admin-api/user/login -X 'POST' -d '{"username":"username","password":"password","plugin":"Builtin"}'

響應示例

Status: 200 OK
{
    "status": 0,
    "msg": "login successful.",
    "data": {
        "_created_unix": "2021-07-26 00:44:40.097306",
        "username": "edge-admin",
        "edge-token": "6332de49089ec6a24567b3efcabb1012139947b0c232a52e85b88cdcb02bd530",
        "id": 1,
        "_modified_unix": "2021-07-26 00:44:40.097306",
        "role": "master",
        "login_2fa": {}
    },
    "time": 1627290462
}

edge-token 的用法

呼叫其他 API 時把 edge-token 設定為 HTTP 頭部,示例:

curl http://{admin-site}/admin-api/user/logout \
-H "edge-token: 2aeac420361ba6c202887452f0ffab8fffc619731cc3daffc6bc7a4707756abf",