court-announcement-detail

法院公告詳情查詢

依法院公告檢索 ID 取得公告類型、公告人、當事人、正文與發布日期。

呼叫價格

25 匠幣/次

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

快速接入

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

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

cURL Python Go Java PHP

cURL 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/court-announcement-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/court-announcement-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/court-announcement-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/court-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-announcement-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;

響應示例

[
  {
    "type": "起诉状副本及开庭传票",
    "announcer": "[河南]郑州市二七区人民法院",
    "litigant": "郑州**置业有限公司",
    "content": "郑州**置业有限公司：本院受理原告***诉你公司房屋买卖合同纠纷一案...",
    "publishDate": "2015-06-03"
  }
]

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

請求欄位

從伺服器發起請求，並在 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`	未標註	未標註	`未標註`
[].type	`string`	否	公告类型	`起诉状副本及开庭传票`
[].announcer	`string`	否	公告人／公告法院	`[河南]郑州市二七区人民法院`
[].litigant	`string`	否	当事人	`郑州**置业有限公司`
[].content	`string`	否	详情正文；长度与完整性以实际返回为准	`郑州置业有限公司：本院受理原告*诉你公司房屋买卖合同纠纷一案...`
[].publishDate	`string`	否	发布日期，不等同于裁判或开庭日期	`2015-06-03`

響應示例

[
  {
    "type": "起诉状副本及开庭传票",
    "announcer": "[河南]郑州市二七区人民法院",
    "litigant": "郑州**置业有限公司",
    "content": "郑州**置业有限公司：本院受理原告***诉你公司房屋买卖合同纠纷一案...",
    "publishDate": "2015-06-03"
  }
]

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

介面簡介

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

介面功能

使用法院公告檢索結果中的 ID，讀取對應單篇公告詳情。紀錄可包含公告類型、公告人、當事人、正文與發布日期，適合從既有清單進入詳情頁。此介面用於中國法院公告資料的單篇讀取，不能直接以企業名稱、個人姓名或案號重新搜尋，也不是臺灣法院裁判書查詢介面。

使用情境

企業資料頁可在使用者選取某則公告後顯示正文；內部核對工具可並列公告人與當事人供人工確認；資料整理系統可保留檢索 ID 和正文的關聯。主體辨識、去重、風險分類及通知由呼叫端處理，名稱相似不足以確認為同一個人或企業。

呼叫與解讀

先從配套法院公告檢索取得原始 ID，再依請求欄位規則準備呼叫當日的 sign，透過 POST 送出。兩個欄位皆必填，跨日需重新產生簽名。確認業務回傳碼後讀取 data 陣列，逐筆呈現類型、公告人、當事人與正文。發布日期代表公告刊登時點，不要直接當成事件發生日期。

範圍與限制

涵蓋範圍取決於資料來源與檢索結果，不保證完整收錄、固定更新頻率或正文完整。文字可能遮蔽、截短或缺少欄位，須保留缺失狀態。NO_RESULTS 表示該 ID 未回傳可用詳情；簽名、參數或授權錯誤屬查詢失敗。公告不能直接證明當事人目前失信、敗訴或承擔特定責任，重要資訊須核對原公告。

常見問題

詳情 ID 要從哪裡取得？

使用配套法院公告檢索的回傳 ID，不能以名稱、案號或其他類型公告的 ID 替代。

為何簽名驗證失敗？

確認依呼叫當日產生完整 32 位 MD5 簽名，不要長期重複使用範例值。

這和開庭公告詳情相同嗎？

兩者是不同入口。此處提供公告類型、公告人與當事人等資料，開庭公告須使用對應介面及 ID。

無結果是否代表沒有公告？

不能如此認定，只能說該 ID 目前沒有可用詳情。須核對檢索來源、資料類型與可存取狀態。

法院公告詳情查詢 API - 工具匠

法院公告詳情查詢

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面功能

使用情境

呼叫與解讀

範圍與限制

常見問題

詳情 ID 要從哪裡取得？

為何簽名驗證失敗？

這和開庭公告詳情相同嗎？

無結果是否代表沒有公告？

相關推薦

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

裁判文書詳情查詢

開庭公告詳情查詢

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面功能

使用情境

呼叫與解讀

範圍與限制

常見問題

詳情 ID 要從哪裡取得？

為何簽名驗證失敗？

這和開庭公告詳情相同嗎？

無結果是否代表沒有公告？

相關推薦

相關工具

相關 API

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

裁判文書詳情查詢

開庭公告詳情查詢