JWT 解析生成

接口标识: jwttool 价格: 0.005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

JWT 解析生成接口支持解码、编码、验签三种操作：解码不校验签名，解析令牌头部与 claims，含 exp 时返回是否过期与剩余秒数；编码用密钥与 claims 生成签名令牌；验签用密钥确认签名有效性，签名无效或已过期都返回明确结论与原因。签名算法支持 HS256 与 RS256，alg=none 的伪造令牌直接拒绝。适合登录态诊断、联调造测试令牌、令牌安全自检等场景。

详细介绍

![JWT 解析生成接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_jwttool__1794363295_48b9f266f7de.png)

联调时要看清令牌里藏了什么、签名对不对？传入 JWT 即可解析头部与载荷，也能用密钥生成一枚新令牌。

## 接口概述
面向身份认证开发与联调中需要读取或签发 JWT 令牌的场景，接口提供解码、编码、验签三种操作：解码不校验签名，直接解析令牌头部与全部 claims，含过期时间时给出是否过期与剩余秒数；编码用密钥与 claims 生成签名令牌，支持 HS256 与 RS256；验签用密钥确认签名有效性，过期与签名无效分别返回明确结论。结果同步返回、字段结构化，适合嵌入登录诊断工具、开放平台自检页与令牌巡检任务。

## 核心能力
1. **解码免验签**：直接解析头部与全部 claims，含 exp 时返回是否过期与剩余秒数。
2. **令牌生成**：密钥加 claims JSON 即可生成签名 JWT，支持 HS256 与 RS256。
3. **签名验证**：validate 用密钥验签，成功、过期、签名无效三种结局都有明确字段结论。
4. **攻击拒绝**：alg=none 的伪造令牌直接拒绝处理，解析不信任未验证的头部声明。

## 产品优势
1. **三合一**：解码、编码、验签共用一个入口，覆盖令牌调试全流程。
2. **接入简单**：POST 同步返回，结果即结构化 JSON。
3. **安全可靠**：伪造算法载荷直接拒绝，验签结论与原因分开返回。
4. **精确规范**：过期判断精确到秒，剩余秒数可直接用于刷新策略。
5. **降本增效**：联调期无需自写解码脚本，令牌自检工具即接即用。

## 效果展示
一句话理解：它就像包裹检查员——既能拆开令牌看里面写了什么，也能用专用封条签发新包裹，还能校验封条是不是真的。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| action | decode | 操作类型：decode 解码 / encode 编码 / validate 验签 |
| token | eyJhbGciOiJIUzI1NiIs…（完整 JWT） | 待解析令牌，decode 与 validate 必传 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 令牌头部 | HS256 算法、JWT 类型 | `header`，含 `alg` 与 `typ` |
| 载荷数据 | sub、name、exp 三项 claims | `payload` |
| 是否过期 | false | `expired`，claims 含 exp 时返回 |
| 过期剩余秒数 | 99216000 | `exp_in_seconds`，负数表示已过期 |

API请求示例：

```
POST /api/jwttool
{
  "action": "decode",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzEwMDEiLCJuYW1lIjoiZGVtbyIsImV4cCI6MTg5MzQ1NjAwMH0.Sig0DemoSignatureDemoSignatureDemo1234"
}
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "header": {
      "alg": "HS256",
      "typ": "JWT"
    },
    "payload": {
      "sub": "user_1001",
      "name": "demo",
      "exp": 1893456000
    },
    "expired": false,
    "exp_in_seconds": 99216000
  },
  "request_id": "e8a0b2c4d6f143579c1e3a5b7d9f0c2e"
}
```

decode 不校验签名；需要确认令牌真伪时改用 validate 并传 secret，返回 signature_valid 与失败原因；encode 则由密钥与 claims 生成新 token。

## 应用场景
- **登录诊断**：解析用户携带的令牌，检查 claims 内容与过期状态。
- **联调造数**：快速生成测试令牌，跑通两端授权流程。
- **安全自检**：确认令牌签名可验证，拦截 alg=none 伪造载荷。
- **令牌巡检**：批量检查在发令牌的剩余有效期，提前触发刷新。

## 应用案例
**后端联调工程师**：排查登录态失效问题时，需要知道令牌里的 claims 与过期时间，此前要手写 base64 解码脚本还常出错。现在直接调 decode 拿到头部与载荷，剩余秒数一目了然，定位一次登录异常从半小时缩短到几分钟。

**开放平台开发者**：需要为接入方生成一批测试令牌跑通授权流程，用 encode 指定 claims 与密钥即时生成，再用 validate 自验签名正确性，一个工具覆盖生成与校验两端，测试准备工作当天完成。

常见问题

Q：decode 会校验签名吗？

A：不会。decode 只解析头部与 claims，便于排查内容；需要确认真伪请用 validate 操作并传入 secret，返回 signature_valid 与失败原因。

Q：支持哪些签名算法？

A：HS256 与 RS256 两种，默认 HS256；alg=none 的令牌被视为伪造载荷直接拒绝。

Q：如何判断令牌是否过期？

A：decode 时若 claims 含 exp，会返回 expired 布尔值与 exp_in_seconds 剩余秒数（负数表示已过期）；validate 遇到过期令牌会返回 expired=true 与提示。

JWT token 身份认证开发工具

接口地址： https://www.phpwc.cn/api/jwttool

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`action`	string	必填	-	操作：decode/encode/validate
`token`	string	选填	-	JWT 令牌
`secret`	string	选填	-	签名密钥
`algorithm`	string	选填	`HS256`	算法：HS256/RS256
`payload`	string	选填	-	encode 的 claims JSON
`verify_signature`	boolean	选填	`false`	decode 时是否验签

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`token`	string	生成的 JWT
`header`−	object	JWT 头部
`alg`	string	算法
`typ`	string	类型
`payload`	object	claims 数据
`expired`	boolean	是否过期
`exp_in_seconds`	int	剩余秒数
`signature_valid`	boolean	签名是否有效
`error_msg`	string	错误信息
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试