JuheApi接口中心
聚合解析 API

接口中心

当前提供视频和图文分享链接解析。下面的示例地址会自动使用当前访问域名，部署到哪个域名就显示哪个域名。

接口分类视频解析
解析入口4 个
健康检查3 个

视频解析

解析抖音、快手、小红书、B站等公开分享链接，返回标题、封面、播放地址或图片列表。

已上线
GET/api/jh?url=分享链接

推荐入口。把分享链接或完整分享文案放到 url 参数里。


      

      

        
GET/api/jh?=分享文案

        
短写法。适合直接把复制出来的分享文案拼到 ?= 后面。

        

      

      

        
POST/api/jh

        
JSON 调用方式。适合小程序、后端服务或第三方系统调用。

        

      

      

        
GET/POST/api/share/parse

        
兼容旧入口，功能等同于 /api/jh。

        

      

    

  


  

    

      

        
服务健康检查

        
每个主要接口都有独立健康检查，便于宝塔守护、反向代理或监控系统判断接口是否可用。

      

      独立检查
    

    

      

        
GET/health

        
全局服务健康检查。

        

      

      

        
GET/api/jh/health

        
聚合解析主接口健康检查。

        

      

      

        
GET/api/share/parse/health

        
兼容解析接口健康检查。

        

      

    

  


  

    

      

        
输出示例

        
下面是随便写的一组示例值，实际返回会按平台解析结果变化。

      

    

    
{
  "code": 200,
  "msg": "解析成功",
  "type": "video",
  "data": {
    "title": "示例作品标题 A1024",
    "cover": "https://cdn.example.com/cover/a1024.jpg",
    "url": "https://api.example.com/api/media/proxy?url=...",
    "quality": "original",
    "author": {
      "name": "示例作者",
      "avatar": "https://cdn.example.com/avatar/u1001.jpg"
    },
    "statistics": {
      "like": 1288,
      "comment": 36,
      "share": 92
    }
  },
  "time": "526ms"
}

  


  

    

      

        
状态和字段说明

        
接入计费系统或小程序时，主要看 code、type 和 data。

      

    

    

      

        
状态code

        

          
200
解析成功或健康检查正常。计费系统建议只在这个状态扣费。

          
400
缺少参数，例如没有传 url、text 或分享文案。

          
404
接口路径不存在。

          
422
页面能访问，但没有解析到可用的视频地址或图片列表。

          
500
服务器内部错误，通常是代码异常、PHP 扩展缺失或运行环境异常。

        

      


      

        
字段顶层字段

        

          
code
业务状态码。成功是 200，失败看 msg。

          
msg
状态说明，例如 解析成功。

          
type
结果类型。常见值：video、image、health。

          
data
实际数据。解析成功时放视频、图片或健康检查信息。

          
time
本次接口耗时，例如 526ms。健康检查接口没有这个字段。

        

      


      

        
字段data 视频/图片字段

        

          
title
作品标题或文案标题。

          
cover
封面图地址。图文类型通常等于第一张图片。

          
url
唯一播放地址。遇到 B 站、抖音防盗链时，这里会自动变成可播放的代理地址。

          
images
图片列表。只有图文作品或图片解析成功时返回。

          
count
图片数量。只有 type=image 时常见。

          
quality
清晰度标识，例如 original、1080p、image。

          
author
作者信息，可能包含 id、name、avatar。

          
music
音乐信息，可能包含 name、author、music_url。

          
statistics
平台统计信息，例如点赞、评论、收藏、分享数量。

        

      


      

        
入参解析接口参数

        

          
url
推荐参数。传分享链接或完整分享文案。

          
text/share/content
备用参数，作用同 url。

          
input/link/q/data
兼容参数，传任意一个都可以触发解析。

          
?=分享文案
短写法，不带参数名，直接把文案放到 ?= 后面。

        

      

    

  


  

    

      

        
计费系统配置

        
第三方接口按下面方式填写，扣费规则建议校验 code 字段。

      

    

    

      
接口地址

      
请求方式
GET

      
用户参数
url，传入分享链接或完整分享文案

      
扣费规则
字段 code 等于 200 时扣费

      
兼容写法