12-卷宗入卷服务接口

简介:12-卷宗入卷服务接口

HOST:127.0.0.1:8200

Version:1.0

[TOC]

接口说明

## 一、http交互

基于Restful风格的Http接口。

接口是Http方式的调用,只要满足接口要求,可以不限于客户端语言,进行接口对接。接口返回格式为JSON。

## 二、接口请求全局参数设置

所有接口都需要请求头携带两个请求头参数,

headers: {

​    ClientId: xxxx,

​    ClientSecret: xxxxxxxxxxxx

}

## 三、接口响应返回值说明

接口响应是否成功,用HTTP状态码标识

状态值 说明
200 接口调用成功
401 Token值错误或已失效,无权访问(一般认为是未登录)
403 禁止访问,无权访问该接口
500 接口异常,返回具体异常信息

500的异常信息示例:


{
  "code": 400,  //业务状态码,其值,参考状态码列表
  "message": "文件扩展名必须是[jpg,jpeg,gif,png,bmp,tif,pdf],文件大小不能超过10M",   //错误提示信息
  "detailMessage": "OCRFileParamter 参数错误",    //错误详情
  "data": null  //返回的数据体,根据部分接口需求,会返回错误的数据体或者传参的原数据,一般情况下,该值为null
}

同步新增文件结构

接口地址:/caseinfo/fyy/file/append 北投接口地址:/caseinfo/fyy/file/append/beitou 华宇接口地址:/caseinfo/fyy/file/append/huayu

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:增量新增文件到卷宗

请求示例:

{
 "caseCode": "10100000637584",
 "caseName": "(xxxx)京xx刑终xx号",
 "caseType": "1",
 "files": [
  {
   "cls": "EFILE",
   "derivatives": [
       {
          "name": "案件登记表",
          "path": "dzjz101-6/2020/01/06/27419099551683401/2092600683589972.pdf",
          "size": 122,
          "type": "PDF"
        },
        {
            "name": "案件登记表",
            "path": "dzjz101-6/2020/01/06/27419099551683401/2092600683589972.jpg",
            "size": 132,
            "type": "THUMBNAIL"
          }
    ],
   "dir": ["正卷","案件登记表"],
   "name": "案件登记表",
   "path": "dzjz101-6/2020/01/06/27419099551683401/2092600683589972.pdf",
   "size": 123,
   "createTime": "2010-01-01 01:01:01",
   "properties":{
      "fileId": "222222222",
      "aa": "bb"
    }            
  }
 ]
}

请求参数:

请求参数:

参数名称 参数说明 in 是否必须 数据类型 schema
fileList fileList body true GXFileListVO GXFileListVO
  caseName 案号 true string
  caseType 案件类型 true string
  files 文件列表 true array FileEntity
    cls EFILE=电子文档,PAPERFILE=纸质文档,默认纸质文档 false string
    createTime 文件创建时间,格式:2010-01-01 01:01:01 false string
    derivatives 其他文件,比如PDF,OCR-JSON,OCR-TEXT,缩略图… false array ExtFileEntity
      id 文件ID,不需要传值,接口调用成功后,返回该值 false integer(int64)
      name 文件名称 true string
      path 文件路径 true string
      size 文件大小,最小单位byte true integer(int64)
      type 文件类型 OCR-JSON,OCR-TEXT,THUMBNAIL=缩略图,PDF false string
    dir 文件所属目录,请填写目录完整路径,比如[“正卷”,“证据”] true array string
    id 文件ID,不需要传值,接口调用成功后,返回该值 false integer(int64)
    name 文件名称 true string
    path 文件路径 true string
    properties 其他属性参数,放入JSON对象数据,比如 properties={“creator”:“guest”,“fileId”:“123456”} false JsonNode JsonNode
    size 文件大小,最小单位byte true integer(int64)

响应状态:

状态码 说明 schema
200 OK GXFileListVO
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
caseName 案号 string
caseType 案件类型 string
files 文件列表 array FileEntity
  cls EFILE=电子文档,PAPERFILE=纸质文档,默认纸质文档 string
  createTime 文件创建时间,格式:2010-01-01 01:01:01 string
  derivatives 其他文件,比如PDF,OCR-JSON,OCR-TEXT,缩略图… array ExtFileEntity
    id 文件ID,不需要传值,接口调用成功后,返回该值 integer(int64)
    name 文件名称 string
    path 文件路径 string
    size 文件大小,最小单位byte integer(int64)
    type 文件类型 OCR-JSON,OCR-TEXT,THUMBNAIL=缩略图,PDF string
  dir 文件所属目录,请填写目录完整路径,比如[“正卷”,“证据”] array string
  id 文件ID,不需要传值,接口调用成功后,返回该值 integer(int64)
  name 文件名称 string
  path 文件路径 string
  properties 其他属性参数,放入JSON对象数据,比如 properties={“creator”:“guest”,“fileId”:“123456”} JsonNode JsonNode
  size 文件大小,最小单位byte integer(int64)

响应示例:

{
 "caseCode": "10100000637584",
 "caseName": "(xxxx)京xx刑终xx号",
 "caseType": "1",
 "files": [
  {
   "id": "1419576746731597825",
   "cls": "EFILE",
   "derivatives": [
       {
          "id": "1419576746731597825",
          "name": "案件登记表",
          "path": "dzjz101-6/2020/01/06/27419099551683401/2092600683589972.pdf",
          "size": 122,
          "type": "PDF"
        },
        {
            "id": "1419576746731597826",
            "name": "案件登记表",
            "path": "dzjz101-6/2020/01/06/27419099551683401/2092600683589972.jpg",
            "size": 132,
            "type": "THUMBNAIL"
          }
    ],
   "dir": ["正卷","案件登记表"],
   "name": "案件登记表",
   "path": "dzjz101-6/2020/01/06/27419099551683401/2092600683589972.pdf",
   "size": 123,
   "createTime": "2010-01-01 01:01:01",
   "properties":{
      "fileId": "222222222",
      "aa": "bb"
    }  
  }
 ]
}

消息通知

消息体结构

{
    "code":0,         //=0 为成功,其他业务状态码,参考状态码列表
    "message":"消息提示",
    "detailMessage":null,
    "data":{
        "id":"任务ID",
        "type":"消息类别",
        "result":{                //返回的消息结果
            .........
        }
    }
}

## 一、统一存储文件变更通知

参数名称 参数说明 类型 schema
code 忽略 string
message 变更信息 string
data object
  id 消息ID string
 type STORAGE_CHANGE string
  result object
    courtCode 法院代码 string
    caseCode 案件标识 string
    caseName 案号 string
    xmlPath xml地址 string
    version 版本值 integer(int64)
    createTime Xml生成时间 string
{
    "code":0,         //=0 忽略
    "message":"变更信息",
    "data":{
        "id":"消息ID",
        "type":"STORAGE_CHANGE",
        "result":{                //返回的消息结果
            "courtCode":"0001",            //法院代码
            "caseCode":"2520201002013555",          //案件标识
            "caseName":"(xxxx)京xxxx执xxx号",          //案号
            "xmlPath":"dzjz101-6/2021/07/22//1295e079-894c-486d-b4b7-26da200b4ba6.xml",      //xml地址
            "version":1,      //版本值
            "createTime":"2020-01-01 08:00:00",      //Xml生成时间
        }
    }
}


状态码列表

状态值 状态说明
10000 数据({0})不存在
10008 案件标识{0}不存在
10009 目录不存在
10010 操作失败
11001 目录({0})不存在
作者:崔启旭  创建时间:2023-04-03 16:04
 更新时间:2024-11-15 23:02