正在读取服务状态…
几步完成,
开始管理会话。
连接宝塔中的 MySQL 数据库,并设置管理密码。配置通过此页面保存。
在宝塔数据库中导入随程序提供的 SQL 文件,然后填写对应的连接信息。
此密码用于访问保存的账户 Cookie,请使用独立的强密码。
初始化服务
填写数据库连接信息
请使用程序启动日志中的安装链接打开此页面。
让账户会话,
有序可控。
登录管理面板,查看已保存账户、复制 Cookie,或尝试刷新会话。
登录管理面板
输入初始化时设置的管理密码
此处为管理面板登录。京东账户登录能力请在进入后查看。
我的账户
集中保存、读取和刷新自己的账户 Cookie。
PT Cookie 与 wskey 分别刷新。 刷新 PT Cookie 不会续期 wskey。旧账户请先手动刷新 wskey,取得时间后按服务端计划自动执行,刷新结果以账户状态为准。原生登录验证成功并核验账户后,可直接保存到这里。
账户列表0
还没有保存的账户
导入已有 Cookie 后,即可在这里复制和刷新。
生成短网址
选择已保存的 wskey 账户,将 HTTP 或 HTTPS 链接转换为京东短网址。
短网址记录
查看原始链接与生成结果,本地缓存永久保存。
| 账户 | 原始链接 | 短网址 | 时间与状态 | 操作 |
|---|
在上方生成短网址后,原始链接和生成结果会保存在这里。
等待载入
短网址 API 文档专用 API Key · 按唯一账户备注直接调用
短网址 API Key
等待读取密钥状态。
此密钥仅用于生成短网址。新密钥只在生成后显示一次,请复制到服务端脚本配置;页面不会把它保存到浏览器存储。
刷新页面或退出后无法再次读取此值。重新生成会让旧密钥立即失效。
POST/api/shorturl
在请求头中携带 Authorization: Bearer <API Key>,直接提交 JSON 即可。此接口仅接受 API Key,服务端脚本无需登录管理员或取得 CSRF Token。
| JSON 字段 | 类型 | 说明 |
|---|---|---|
remark | 字符串 | 面板中的唯一账户备注,须完整匹配并区分大小写;对应账户必须含 wskey。 |
url | 字符串 | 完整 HTTP 或 HTTPS 地址,最长 16,000 字节,不能包含用户名、密码或空白控制字符。 |
forceRefresh | 布尔值,可选 | 默认 false 使用永久缓存;true 跳过缓存,重新生成并成功替换记录。失败保留原记录。 |
expectedPin | 字符串,可选 | 对应账户已核对的 pt_pin;提供后不匹配会拒绝请求。 |
请求示例 {"remark":"我的京东账户","url":"https://item.jd.com/123.html","forceRefresh":false},成功返回 {"shortUrl":"https://3.cn/example","cacheHit":false}。同一账户、同一原网址命中缓存时,cacheHit 为 true;强制重新生成成功时为 false,上游仍可能返回相同链接。本地缓存没有到期时间,短链接能否访问取决于京东服务。错误返回 {"error":"错误码","message":"说明"}。
PHP 直接调用示例
PHP 5.6 及以上,需要 curl 扩展。基址与备注使用当前选择;填写原网址,并设置 JD_PANEL_SHORTURL_API_KEY 环境变量。
仅发送一次 POST /api/shorturl;复制示例不会包含本次生成的真实密钥。若短网址只是联盟转链的可选步骤,捕获失败后继续使用原链接进行联盟转链。
常见错误与处理
| HTTP 状态 | 错误码 | 处理 |
|---|---|---|
| 401 | API_KEY_INVALID | 检查 Bearer 密钥;重置后需更新脚本中的旧密钥。 |
| 403 | ORIGIN_REJECTED | 浏览器需同源调用;服务端脚本无需设置 Origin。 |
| 400 | INVALID_URL / INVALID_ACCOUNT_SELECTOR | 检查链接格式与长度,只提供备注或账户 ID 中的一项。 |
| 404 | REMARK_NOT_FOUND | 核对完整备注及大小写。 |
| 409 | AMBIGUOUS_REMARK / REMARK_EXISTS | 使用唯一备注;新建账户不能重名。 |
| 409 | ACCOUNT_MISMATCH | 核对 expectedPin 是否属于所选账户。 |
| 409 | APP_LOGIN_REQUIRED | 选择已保存 wskey 的账户。 |
| 502 | 上游错误码 | 按返回说明检查账户状态,稍后再试。 |
原生登录验证
使用本人已注册的设备资料,完成一次新的短信登录。
完成本次登录
验证码、短信发送和登录均由你手动操作。
等待加载。
本次请求诊断
复制诊断仅包含阶段、验证码类型、状态码、长度、耗时及关联检查结果,不含服务端提示原文、手机号、验证码内容或登录票据。
请根据图片提示完成验证码。
请用鼠标或手指拖动,松开后点击提交。如需重做,请点击“重新旋转”。
已取得新的 App 登录票据
使用说明与会话有效期
请先导入已注册设备的资料,再开始新会话。按照页面提示完成图片点击、画线或单圆图旋转验证码;短信登录结果以本次服务响应为准。
本次会话有效期为 15 分钟,清理会话或退出管理会删除临时输入与未保存的登录票据。设备资料继续加密保存在服务器,下次可直接使用。
登录成功后可复制新的 App 票据,或填写备注并点击「核验并保存账户」。保存时会进行同账号 PT 核验,通过后加入 Cookie 管理;单独核验为可选操作。核验失败会保留本次已成功取得的 App 票据,直到会话结束。
暂时无法连接服务
请检查程序是否仍在运行。