> ## Documentation Index
> Fetch the complete documentation index at: https://www.bazhuayu.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取全新 Token

> **所需套餐：** 全部

## 端点

```
POST https://openapi.bazhuayu.com/token
```

## 描述

你需要提供一次八爪鱼平台的登录账号和密码来获取全新【Access Token】。

## 请求头

| 参数             | 类型     | 必填 | 说明               |
| -------------- | ------ | -- | ---------------- |
| `Content-Type` | String | 是  | application/json |

**请求头示例**

```json theme={null}
{
  "Content-Type": "application/json"
}
```

## 请求体

| 参数           | 类型     | 必填 | 说明                |
| ------------ | ------ | -- | ----------------- |
| `username`   | String | 是  | 用户名(支持用户名,邮箱,手机号) |
| `password`   | String | 是  | 密码                |
| `grant_type` | String | 是  | 固定值填写password     |

**请求体示例**

```json theme={null}
{
  "username": "username",
  "password": "password",
  "grant_type": "password"
}
```

## 响应

| 参数              | 类型        | 必填 | 说明                                          |
| --------------- | --------- | -- | ------------------------------------------- |
| `data`          | Object\[] | 是  | 响应数据                                        |
| `access_token`  | String    | 是  | 访问令牌                                        |
| `expires_in`    | Date      | 是  | access\_token有效时间（秒）（推荐在有效期间内推荐重复使用），有效期为1天 |
| `token_type`    | String    | 是  | 令牌类型                                        |
| `refresh_token` | String    | 是  | 刷新access\_token的凭证                          |
| `requestId`     | String    | 是  | 请求Id                                        |

**成功示例**

```json theme={null}
{
 "data": {
 "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6ImdXS3hWc0F4SHhaMDlDcWh6NkNJb3ciLCJ0eXAiOiJhdCtqd3QifQ.eyJuYmYiOjE2MzY0NjIyNzAsImV4cCI6MTYzNjU0ODY2OSwiaXNzIjoiaHR0cDovL3Rlc3QuaWRlbnRpdHkuYmF6aHVheXUuY29tIiwiY2xpZW50X2lkIjoiT2N0b3B1cyIsInN1YiI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImF1dGhfdGltZSI6MTYzNjQ2MjI3MCwiaWRwIjoibG9jYWwiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL25hbWUiOiJ0ZXN0d2VuIiwicHJlZmVycmVkX3VzZXJuYW1lIjoidGVzdHdlbiIsInVuaXF1ZV9uYW1lIjoidGVzdHdlbiIsInJlZ2lzdGVyX2RhdGUiOiIxMS8wNC8yMDE2IDA4OjM4OjE2ICswODowMCIsImxhc3RfbG9naW5fZGF0ZSI6IjA0LzIyLzIwMTkgMDk6MDE6MDIgKzA4OjAwIiwibGFzdF9wYXNzd29yZF9jaGFuZ2VkX2RhdGUiOiIwMS8yMy8yMDE5IDA4OjMwOjMxICswODowMCIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbCI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwic2NvcGUiOlsiZW1haWwiLCJvcGVuaWQiLCJyb2xlcyIsIm9mZmxpbmVfYWNjZXNzIl0sImFtciI6WyJwd2QiXX0.ARhbBfzI1xS6yo-Ue1CFHzMaUIfzw4gJlubNBOkUT4SSTlhuS4bVQ4t4UHuYGbE9VX6XgNVgkcDnx6XapqcPohSy7vPv9TIAsjtbrQSA3mj13SnVVAPWwfAVJ-I7g9HDnyPEEOVSvmZUJhiz-irH5L0ojbnt3ck2rQ9tIFuSd7j2eh5BS4ItjNoHY00rh_QPZltk66a9q-fNE33GrxOaXUdHH47WMlsENnh1gybB7QtGtd6bZ982Qa9JljpFnZWSdEf4VfkN4JmhkUTTC908DqS3stT-LD-9tpztFwB54sd0D4CyOBnESkKrUwjxchYYZo4l1O7auiZVGV48YhZYMw",
 "expires_in": "86399",
 "token_type": "Bearer",
 "refresh_token": "SSc1Uf56BRfNfSewsZ0FJCHjfqI5FwGW3k2QfiRplN8",
 },
 "requestId": "0HMD3FSLHJRVO:00000002"
}
```

## 错误响应

| 参数          | 类型     | 必填 | 说明         |
| ----------- | ------ | -- | ---------- |
| `requestId` | String | 是  | 请求Id       |
| `error`     | Object | 是  | 错误信息，参考错误码 |
| `code`      | String | 是  | 错误码        |
| `message`   | String | 是  | 错误描述       |

**错误示例**

```json theme={null}
{
  "error": {
    "code": "Invalid.Grant",
    "message": "用户名或密码错误"
  },
  "requestId": "0HMD43G9J9JV9:00000001"
}
```

<ParamField header="Content-Type" type="string" default="application/json" required hidden />

<ParamField body="username" type="string" required hidden />

<ParamField body="password" type="string" required hidden />

<ParamField body="grant_type" type="string" default="password" initialValue="password" required hidden />