豆瓣 API - 主题详情 (V1)
检索由 subjectId 标识的特定主题的详细信息。
典型用例：
- 在应用程序或网站中显示完整的主题元数据。
- 支持内容分析、编目或详情页面渲染。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 此 API 服务的访问令牌。 |
subjectId | query | string | 是 | 豆瓣电影或电视剧条目的唯一标识符。 |
代码示例
💡 环境说明
默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。
bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/douban/get-subject-detail/v1?token=YOUR_API_KEY&subjectId=VALUE"text
我想使用 Just One API 提供的“主题详情 (V1)”接口。
接口地址: https://api.justoneapi.com/api/douban/get-subject-detail/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douban-apis/subject-details-v1-zh.json
请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- subjectId (query): 豆瓣电影或电视剧条目的唯一标识符。 (必填)
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/douban/get-subject-detail/v1?token=YOUR_API_KEY&subjectId=VALUE"
response = requests.get(url)
print(response.json())js
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/douban/get-subject-detail/v1?token=YOUR_API_KEY&subjectId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/douban/get-subject-detail/v1?token=YOUR_API_KEY&subjectId=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/douban/get-subject-detail/v1?token=YOUR_API_KEY&subjectId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/douban/get-subject-detail/v1?token=YOUR_API_KEY&subjectId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果
json
{
"code": 0,
"data": {
"title": "镖人：风起大漠",
"year": "2026",
"poster": "https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2929760596.webp",
"director": "袁和平",
"writer": "俞白眉 / 苏照彬 / 陈大利 / 杨子",
"cast": "吴京 / 谢霆锋 / 于适 / 陈丽君 / 孙艺洲 / 此沙 / 李云霄 / 梁家辉 / 张晋 / 惠英红 / 张译 / 李连杰 / 刘耀文 / 熊瑾怡 / 莒谦朗 / 白那日苏 / 梁壁荧 / 文俊辉 / 董思成 / 林秋楠 / 景瓷 / 张艺泷 / 李嘉辉 / 寇占文 / 代乐乐 / 释彦能 / 徐向东 / 淳于珊珊 / 孟鹤堂 / 于荣光 / 陈少熙 / 赵箭 / 袁和平更多...",
"type": "动作/武侠/古装",
"region": "中国大陆",
"language": "汉语普通话",
"release_date": "2026-02-17(中国大陆)",
"episodes": "",
"duration": "126分钟",
"alias": "镖人(电影版) / 镖人 / Blades of the Guardians: Wind Rises in the Desert",
"imdb": "tt32649961",
"rating": "7.5",
"rating_count": "330653"
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。