how to get token

[jzh971018]

How to obtain the Authorization in the picture?

[dosubot[bot]]

Hi @jzh971018! I'm Dosu and I’m helping the ragflow team.

To get the Authorization token for RAGFlow API requests, you have two main options:

1. Login Token (Session Token):
   Register and log in using the API endpoints /v1/user/register and /v1/user/login. The login response will include an Authorization token in the response headers. Use this token in your API requests as Authorization: <login_token>. Note: this token typically expires within one day and is required for endpoints that need user authentication (details & example, step-by-step).

2. API Key (API Token):
   After logging in, send a POST request to /v1/system/new_token with your login token in the Authorization header. The response will include a new API key. Use this as Authorization: Bearer <API_KEY> in your requests. You can manage (list, create, delete) API keys via /v1/system/token_list and related endpoints (reference, API key flow).

If you are already logged in via the web UI, you can inspect your browser's network requests to find the current Authorization token being used (how-to). The frontend stores this token in localStorage and uses it for API calls.

API access is only available in self-hosted RAGFlow instances, not in the public demo environment (see FAQ).

Let me know if you need example code for any of these steps!

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[jzh971018]

@dosu 我现在要的不是api-key，我想要的是ragflow 页面登录后文件请求创建文件接口中请求头里的authorization，类似"ImQ4YmQ2YTM4NTAxMTExZjBhYjg3MWU5YjBlZDMzOWFkIg.aFkZ6g.icRfjBsPbwZkT_mLhLXgYf0BUmU
",而不是类似"ragflow-E1M2U0MmY2NGE5MjExZjBiOGE4YTZlYm"

[dosubot[bot]]

你要的这种 Authorization（比如 "ImQ4YmQ2YTM4NTAxMTExZjBhYjg3MWU5YjBlZDMzOWFkIg.aFkZ6g.icRfjBsPbwZkT_mLhLXgYf0BUmU"）其实就是 RAGFlow 登录后的 session token，不是 API key。这个 token 是在你登录成功后由后端生成并返回，前端会自动存到浏览器的 localStorage 里，并在每次 API 请求时自动加到 Authorization header 上。

获取方式有两种：

1. 浏览器开发者工具
   打开 F12，切到 Network，随便点一个需要登录的接口（比如你截图里的 /v1/file/create），在请求头里就能看到 Authorization 字段，直接复制即可。

2. localStorage
   在控制台（Console）输入：

   localStorage.getItem('Authorization')

   就能拿到当前 session token。

这个 token 有效期一般是一天，过期后需要重新登录获取。你可以用它直接请求需要登录的接口，比如 curl 或 Postman，只要加上：

Authorization: <你的 session token>

即可，无需 Bearer 前缀。

这种 session token 没有被限制只能在浏览器用，只要 token 有效，任何客户端都能用来访问 API（安全性靠 HTTPS 和 token 保密）参考 代码实现。

如果还有疑问可以继续问！

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[jzh971018]

你们有提供接口来获取这种Authorization吗

[dosubot[bot]]

有，RAGFlow 提供了接口来获取你说的这种 Authorization（session token）：

直接用 POST /v1/user/login（或 /login）接口，传入 email 和 password，登录成功后，响应的 HTTP Header 里会有 Authorization 字段，这个就是你要的 token。前端也是用这个 token 作为后续所有 API 请求的认证凭证。

示例（Python requests）：

import requests

url = "http://你的ragflow地址/v1/user/login"
data = {"email": "你的邮箱", "password": "你的密码"}
resp = requests.post(url, json=data)
token = resp.headers["Authorization"]
print(token)

只要拿到这个 token，后续所有需要登录的接口都可以直接加上 Authorization: <token> 访问，无需 Bearer 前缀。每次登录会生成新的 token，旧的会失效（同一账号只能有一个有效 session）参考。

如果登录失败会返回 401 错误。没有其它特殊要求，不需要多因素认证，直接用账号密码即可。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}