呼叫價格
25 匠幣/次
快速接入
保持統一返回結構,直接透過服務端發起請求即可接入。
https://openapi.toolkk.com/v1/judgment-document-detailcURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/judgment-document-detail' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "sign": "841ef7c95cd3a25b3187cf4aa193c016",\n "id": "64FA350DFE6CBB25"\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/judgment-document-detail"
payload = {
"sign": "841ef7c95cd3a25b3187cf4aa193c016",
"id": "64FA350DFE6CBB25"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/judgment-document-detail"
payload := []byte("{\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"id\": \"64FA350DFE6CBB25\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 示例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"id\": \"64FA350DFE6CBB25\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/judgment-document-detail"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/judgment-document-detail';
$payload = "{\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"id\": \"64FA350DFE6CBB25\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;響應示例
[
{
"court": "河北省高级人民法院",
"title": "厦门***有限公司与**侵害商标权纠纷二审民事判决书",
"caseCode": "(2015)冀民三终字第21号",
"content": "上诉人厦门***有限公司(以下简称厦门**公司)因与被上诉人**侵害商标...",
"publishDate": "2014-04-27"
}
]範例用於理解回傳結構,實際結果以介面回傳為準。
- 鑑權方式
- 請求頭傳入 X-API-Key
- 預設限流
- 60 次/分鐘
- 超時時間
- 10000 ms
服務端呼叫時,將 API Key 放在 X-API-Key 請求頭中。
建議按 response code 與業務欄位雙重判斷呼叫結果。
高頻呼叫場景請結合速率限制與重試策略使用。
請求欄位
從伺服器發起請求,並在 X-API-Key 標頭中傳入金鑰。
請求欄位
欄位來自介面結構定義。未提供的說明和範例會標為未標註。
| 欄位路徑 | 型別 | 必填 | 說明 | 示例值 |
|---|---|---|---|---|
| sign | string | 是 | 调用当日签名:对 6tj4u 与调用日期 yyyyMMdd 的拼接字符串计算 32 位 MD5。日期以供应商当日校验为准;示例仅适用于 2026-10-09,跨日需重新生成。 | 841ef7c95cd3a25b3187cf4aa193c016 |
| id | string | 是 | 裁判文书id,必填,填写法院裁判文书检索得到的一个id | 64FA350DFE6CBB25 |
請求示例
{
"sign": "841ef7c95cd3a25b3187cf4aa193c016",
"id": "64FA350DFE6CBB25"
}- 鑑權方式
- 請求頭傳入 X-API-Key
- 預設限流
- 60 次/分鐘
- 超時時間
- 10000 ms
響應欄位
範例用於理解回傳結構,實際結果以介面回傳為準。
響應欄位
欄位來自介面結構定義。未提供的說明和範例會標為未標註。
| 欄位路徑 | 型別 | 必填 | 說明 | 示例值 |
|---|---|---|---|---|
| [] | object | 未標註 | 未標註 | 未標註 |
| [].court | string | 否 | 法院 | 河北省高级人民法院 |
| [].title | string | 否 | 标题 | 厦门***有限公司与**侵害商标权纠纷二审民事判决书 |
| [].caseCode | string | 否 | 案号 | (2015)冀民三终字第21号 |
| [].content | string | 否 | 详情正文;长度与完整性以实际返回为准 | 上诉人厦门***有限公司(以下简称厦门**公司)因与被上诉人**侵害商标... |
| [].publishDate | string | 否 | 发布日期,不等同于裁判或开庭日期 | 2014-04-27 |
響應示例
[
{
"court": "河北省高级人民法院",
"title": "厦门***有限公司与**侵害商标权纠纷二审民事判决书",
"caseCode": "(2015)冀民三终字第21号",
"content": "上诉人厦门***有限公司(以下简称厦门**公司)因与被上诉人**侵害商标...",
"publishDate": "2014-04-27"
}
]$.rc == '0000'介面簡介
介面功能、應用情境、使用限制與常見問題。
介面功能
使用裁判文書檢索結果中的 ID 讀取對應文書詳情。紀錄可包含法院、標題、案號、正文與發布日期,適合將既有清單的一筆資料展開成閱讀頁。本介面處理中國法院資料,不是臺灣司法院裁判書開放 API;文書標題須搭配正文核對,不能只憑標題推論案件結果。
使用情境
案件資料工具可顯示已定位文書的法院與案號;企業資料頁可供使用者閱讀某筆檢索紀錄的正文;研究系統可儲存 ID 與文字的關聯。摘要、關鍵字擷取、類似案例推薦及主體辨識由呼叫端另外處理,查詢不會提供裁判結果預測或風險評分。
呼叫與解讀
先在配套裁判文書檢索中取得詳情 ID,依請求規則產生呼叫當日的 sign,再以 POST 送出。不能把案號或企業名稱填入 id,也不要混用其他資料類別的 ID。確認業務回傳碼後讀取 data 陣列,分別顯示法院、標題、案號、正文及發布日期;缺少欄位時保留空值或標示未知。
範圍與限制
公開欄位沒有獨立的生效日期、上訴狀態、勝敗訴標記或全文附件網址,不能用發布日期自行補齊。正文長度、遮蔽情形與可用性以回傳內容為準,範例僅說明結構。NO_RESULTS 代表該 ID 無可用詳情;重要判斷須核對原文及後續文書,單篇紀錄不代表主體的全部訴訟情況。
常見問題
能直接用案號查詢嗎?
不能。輸入需要配套檢索回傳的詳情 ID,案號是詳情中的輸出資料。
發布日期就是裁判日期嗎?
不是。publishDate 指資料發布日期,目前回應沒有獨立裁判日期欄位,兩者不能混用。
是否一定有完整正文或 PDF?
不能保證。目前提供 content 文字,沒有 PDF 下載欄位;缺漏、遮蔽或截短內容依回傳結果呈現。
查詢失敗如何處理?
先核對 ID 來源與當日簽名,再區分無結果、參數錯誤和服務失敗,不要把失敗回應記為沒有案件。