呼叫價格
20 匠幣/次
快速接入
保持統一返回結構,直接透過服務端發起請求即可接入。
https://openapi.toolkk.com/v1/trial-procedure-searchcURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/trial-procedure-search' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "entityName": "深圳市晟通物流有限公司",\n "sign": "841ef7c95cd3a25b3187cf4aa193c016",\n "matchType": "0"\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/trial-procedure-search"
payload = {
"entityName": "深圳市晟通物流有限公司",
"sign": "841ef7c95cd3a25b3187cf4aa193c016",
"matchType": "0"
}
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/trial-procedure-search"
payload := []byte("{\n \"entityName\": \"深圳市晟通物流有限公司\",\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"matchType\": \"0\"\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 \"entityName\": \"深圳市晟通物流有限公司\",\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"matchType\": \"0\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/trial-procedure-search"))
.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/trial-procedure-search';
$payload = "{\n \"entityName\": \"深圳市晟通物流有限公司\",\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"matchType\": \"0\"\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;響應示例
{
"count": 1,
"list": [
{
"areaName": "",
"litigant": "原告:某银行有限公司;被告:深圳市**物流有限公司;",
"accuser": "某银行有限公司",
"defender": "深圳市**物流有限公司",
"others": "",
"courtName": "",
"caseCode": "(2014)深盐法执字第00269号",
"caseStat": "结案",
"openTime": "",
"trialTime": "",
"closeTime": "2014-10-09",
"program": "",
"reason": "",
"caseType": "",
"target": ""
}
]
}範例用於理解回傳結構,實際結果以介面回傳為準。
- 鑑權方式
- 請求頭傳入 X-API-Key
- 預設限流
- 60 次/分鐘
- 超時時間
- 10000 ms
服務端呼叫時,將 API Key 放在 X-API-Key 請求頭中。
建議按 response code 與業務欄位雙重判斷呼叫結果。
高頻呼叫場景請結合速率限制與重試策略使用。
請求欄位
從伺服器發起請求,並在 X-API-Key 標頭中傳入金鑰。
請求欄位
欄位來自介面結構定義。未提供的說明和範例會標為未標註。
| 欄位路徑 | 型別 | 必填 | 說明 | 示例值 |
|---|---|---|---|---|
| entityName | string | 是 | 当事人关键字,必填 | 深圳市晟通物流有限公司 |
| sign | string | 是 | 调用当日签名:对 6tj4u 与调用日期 yyyyMMdd 拼接字符串计算 32 位 MD5。样例仅适用于 2026-10-09,跨日重新生成;不要把示例值作为默认常量。 | 841ef7c95cd3a25b3187cf4aa193c016 |
| matchType | string | 否 | 匹配类型,0:模糊匹配;1:精确匹配.可选,默认模糊匹配 | 0 |
請求示例
{
"entityName": "深圳市晟通物流有限公司",
"sign": "841ef7c95cd3a25b3187cf4aa193c016",
"matchType": "0"
}- 鑑權方式
- 請求頭傳入 X-API-Key
- 預設限流
- 60 次/分鐘
- 超時時間
- 10000 ms
響應欄位
範例用於理解回傳結構,實際結果以介面回傳為準。
響應欄位
欄位來自介面結構定義。未提供的說明和範例會標為未標註。
| 欄位路徑 | 型別 | 必填 | 說明 | 示例值 |
|---|---|---|---|---|
| count | integer | 否 | 数据源报告的结果总数,不保证等于本次 list 长度 | 1 |
| list | array | 否 | 本次返回记录;文档未提供分页请求字段 | 未標註 |
| list[] | object | 未標註 | 未標註 | 未標註 |
| list[].areaName | string | 否 | 地区名称 | 未標註 |
| list[].litigant | string | 否 | 当事人文本 | 原告:某银行有限公司;被告:深圳市**物流有限公司; |
| list[].accuser | string | 否 | 原告 | 某银行有限公司 |
| list[].defender | string | 否 | 被告 | 深圳市**物流有限公司 |
| list[].others | string | 否 | 其他当事人 | 未標註 |
| list[].courtName | string | 否 | 法院名称 | 未標註 |
| list[].caseCode | string | 否 | 案号 | (2014)深盐法执字第00269号 |
| list[].caseStat | string | 否 | 数据源案件状态;不表示当前最终法律结论 | 结案 |
| list[].openTime | string | 否 | 立案时间;空值表示未返回 | 未標註 |
| list[].trialTime | string | 否 | 开庭时间;空值表示未返回 | 未標註 |
| list[].closeTime | string | 否 | 结案时间;空值表示未返回 | 2014-10-09 |
| list[].program | string | 否 |
介面簡介
介面功能、應用情境、使用限制與常見問題。
介面能力
依當事人關鍵字檢索資料來源中的中國法院審判流程紀錄,回傳結果總數及本次案件清單。紀錄可包含地區、當事人文字、原被告、法院名稱、案號、案件狀態及時間欄位。此介面直接提供案件紀錄,沒有摘要 ID 或配套單篇詳情入口;欄位可用程度依回傳資料判斷。
使用情境
案件資料頁可並列顯示案號、當事人及來源狀態,供人員核對;內部資料系統可保存立案、開庭、結案時間並保留缺漏標記;企業資料工具可整理名稱比對候選。主體確認、去重、時間軸及狀態提醒由呼叫端完成,介面不會主動推播案件變動。
呼叫與解讀
準備 entityName 及呼叫當日 sign,以 POST 提交;matchType 可選擇模糊或精確比對。確認業務回傳碼後讀取 count 及 list,結合 caseCode、courtName 及當事人資訊核對紀錄。caseStat 是來源狀態欄位;openTime、trialTime、closeTime 未回傳時須保留空值,不宜用範例日期補齊或當作目前日期。
範圍與限制
目前沒有日期、法院、頁碼、高亮或身分證號碼選項,亦未明確定義多關鍵字加號語法。count 不保證等於本次清單長度。來源沒有固定更新頻率或完整性承諾,空法院、狀態或時間只能視為未提供資訊。歷史結案狀態不能推導為目前最終狀態、勝敗訴或義務履行,重要事項須核對法院原始紀錄。
常見問題
能以回傳 ID 查詢詳情嗎?
此回應沒有 id 或 content 欄位,不能沿用公告或裁判文書的摘要轉詳情流程。
結案就代表義務已履行嗎?
不代表。caseStat 是來源案件狀態文字,不足以判斷履行情形或目前法律責任。
立案或開庭時間為空怎麼辦?
顯示未提供或保留空值,範例中有多個空欄位,不宜由結案時間反推其他時間。
可以分頁取得全部案件嗎?
目前沒有頁碼或容量欄位,count 只是來源報告總數,不能承諾取得所有紀錄。