court-hearing-announcement-detail

開庭公告詳情查詢

依開庭公告檢索 ID 取得地區代碼、地區名稱、法院、標題與公告正文。

呼叫價格

25 匠幣/次

快速接入請求欄位響應欄位介面簡介

快速接入

保持統一返回結構，直接透過服務端發起請求即可接入。

POSThttps://openapi.toolkk.com/v1/court-hearing-announcement-detail

cURL Python Go Java PHP

cURL 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/court-hearing-announcement-detail' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "sign": "841ef7c95cd3a25b3187cf4aa193c016",\n  "id": "2E387DC3F65E25FE"\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/court-hearing-announcement-detail"
payload = {
  "sign": "841ef7c95cd3a25b3187cf4aa193c016",
  "id": "2E387DC3F65E25FE"
}

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/court-hearing-announcement-detail"
    payload := []byte("{\n  \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n  \"id\": \"2E387DC3F65E25FE\"\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\": \"2E387DC3F65E25FE\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/court-hearing-announcement-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/court-hearing-announcement-detail';
$payload = "{\n  \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n  \"id\": \"2E387DC3F65E25FE\"\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;

響應示例

[
  {
    "areaCode": "110000",
    "areaName": "北京市",
    "court": "北京知识产权法院",
    "title": "北京知识产权法院开庭公告",
    "content": "我院定于二〇一五年四月十四日 上午九时三十分,在本院第一法庭依法公开开庭审理北京百度网讯科技有限公司与北京奇虎科技有限公司不正当竞争纠纷一案。"
  }
]

範例用於理解回傳結構，實際結果以介面回傳為準。

請求欄位

從伺服器發起請求，並在 X-API-Key 標頭中傳入金鑰。

請求欄位

欄位來自介面結構定義。未提供的說明和範例會標為未標註。

欄位路徑	型別	必填	說明	示例值
sign	`string`	是	调用当日签名：对 6tj4u 与调用日期 yyyyMMdd 的拼接字符串计算 32 位 MD5。日期以供应商当日校验为准；示例仅适用于 2026-10-09，跨日需重新生成。	`841ef7c95cd3a25b3187cf4aa193c016`
id	`string`	是	法院开庭公告id,必填,填写法院开庭公告检索得到的一个id	`2E387DC3F65E25FE`

請求示例

{
  "sign": "841ef7c95cd3a25b3187cf4aa193c016",
  "id": "2E387DC3F65E25FE"
}

鑑權方式: 請求頭傳入 X-API-Key
預設限流: 60 次/分鐘
超時時間: 10000 ms

響應欄位

範例用於理解回傳結構，實際結果以介面回傳為準。

響應欄位

欄位來自介面結構定義。未提供的說明和範例會標為未標註。

欄位路徑	型別	必填	說明	示例值
[]	`object`	未標註	未標註	`未標註`
[].areaCode	`string`	否	地区编码	`110000`
[].areaName	`string`	否	地区名称	`北京市`
[].court	`string`	否	法院	`北京知识产权法院`
[].title	`string`	否	标题	`北京知识产权法院开庭公告`
[].content	`string`	否	详情正文；长度与完整性以实际返回为准	`我院定于二〇一五年四月十四日上午九时三十分,在本院第一法庭依法公开开庭审理北京百度网讯科技有限公司与北京奇虎科技有限公司不正当竞争纠纷一案。`

響應示例

[
  {
    "areaCode": "110000",
    "areaName": "北京市",
    "court": "北京知识产权法院",
    "title": "北京知识产权法院开庭公告",
    "content": "我院定于二〇一五年四月十四日 上午九时三十分,在本院第一法庭依法公开开庭审理北京百度网讯科技有限公司与北京奇虎科技有限公司不正当竞争纠纷一案。"
  }
]

成功判定$.rc == '0000'

介面簡介

介面功能、應用情境、使用限制與常見問題。

介面功能

使用開庭公告檢索結果中的 ID，讀取對應公告詳情。紀錄可包含地區代碼、地區名稱、法院、標題及正文，適合從既有清單進入閱讀頁。這是中國法院資料的詳情介面；開庭安排可能寫在正文，目前沒有獨立開庭時間或地點欄位，須保留原文供核對。

使用情境

案件管理工具可展開已找到的公告；客服或內部資料頁可顯示法院與正文供人工確認；資料系統可保留 ID 與詳情的關聯。如要從正文製作行事曆或提醒，呼叫端須自行擷取並核對時間、地點，再處理時區及後續變更，查詢不會自動排程或發送通知。

呼叫與解讀

先取得配套開庭公告檢索的原始 ID，依請求規則準備呼叫當日 sign，以 POST 送出。兩者皆必填，舊日期簽名可能無法通過驗證。確認業務回傳碼後逐筆讀取 data 陣列，搭配地區、法院與標題呈現正文。地區代碼以字串保存，範例中的歷史時間不能當成目前有效安排。

範圍與限制

涵蓋範圍、更新間隔及正文完整性沒有固定保證；改期、取消或後續公告須向法院與原始發布管道確認。欄位為空不表示沒有安排。NO_RESULTS 代表該 ID 無可用詳情，簽名或服務錯誤則是查詢失敗。開庭公告不是裁判結果，不能據以判斷責任、勝敗訴或案件最終狀態。

常見問題

能列出某法院今天所有開庭嗎？

不能。此介面依詳情 ID 查詢，沒有日期、法院名稱或分頁篩選；須先檢索取得紀錄。

如何取得開庭時間與地點？

目前沒有獨立欄位。若正文包含資訊，可由呼叫端擷取並核對原始公告，不要假設每筆都包含。

地區代碼要轉成數字嗎？

不建議。areaCode 是識別代碼，以字串儲存與顯示，不要用作數量計算。

能直接產生提醒嗎？

查詢不提供通知功能。呼叫端須確認正文時間及後續變更，再自行製作行事曆與提醒。

開庭公告詳情查詢 API - 工具匠

開庭公告詳情查詢

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面功能

使用情境

呼叫與解讀

範圍與限制

常見問題

能列出某法院今天所有開庭嗎？

如何取得開庭時間與地點？

地區代碼要轉成數字嗎？

能直接產生提醒嗎？

相關推薦

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

法院公告詳情查詢

裁判文書詳情查詢

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面功能

使用情境

呼叫與解讀

範圍與限制

常見問題

能列出某法院今天所有開庭嗎？

如何取得開庭時間與地點？

地區代碼要轉成數字嗎？

能直接產生提醒嗎？

相關推薦

相關工具

相關 API

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

法院公告詳情查詢

裁判文書詳情查詢