个人诉讼信息查询 API: Factor/lawsuit

概览

Factor/lawsuit是submail的个人诉讼信息查询API，输入姓名、手机号码、身份证号，返回个人涉诉详情列表。

URL

<主> http://tpa.mysubmail.com/factor/lawsuit  
<备> https://tpa.mysubmail.com/factor/lawsuit

http请求方式

请求方式	content-type设置
http post	multipart/form-data、x-www-form-urlencoded、application/json

返回参数格式

jsonString

请求参数说明

参数	是否必填	类型	类型
appid	是	string	在 SUBMAIL 身份认证服务中创建并且认证通过的应用 ID
timestamp	是	string	UNIX 时间戳
signature	是	string	签名，详细规则看下方介绍
idNo	是	string	身份证号码
name	是	string	用户姓名
mobile	是	string	用户手机号码（手机号码实名认证信息需和待验证用户姓名身份证号码保持一致）

signature创建规则

请将以下参数按照字段升序（A-Z）排列 appkey 、idNo 、mobile 、name 、timestamp
创建签名字符串：以"key=value" + "&"（连接符）+ "key=value" 的方式连接所有参数
创建签名：拼接签名字符串示例string = "appkey=xxxx&idNo=xxxx&mobile=xxxx&name=xxxx×tamp=xxxxxxxxxx"，然后使用sha256(string)创建签名
注：中文需要使用urlencode处理后再参与创建签名

响应消息

API请求失败
{
    'status'  : 'error' ,                                          // 状态描述
    'send_id' : 'ee05d1635db847a2bf3c8317434539d6',                // API流水号
    'code'    : 1201 ,                                             // API返回的状态码    详情查看 API错误代码与描述  文档
    'msg'     : 'Incorrect APP ID.' ,                              // API返回的描述、  
}

API请求成功
{
    'status'  : 'success' ,                                       // 状态描述
    'send_id' : 'ee05d1635db847a2bf3c8317434539d6',               // API流水号
    'result' : {
        'code'      => '02',                                       //结果状态码  01:无记录  02：有记录
        'msg'       => 'N条结果',                                   //结果描述
        'info'      => "[{...},{...}]"                             //诉讼详细信息  可能存在多条数据的情况
    };
    //可能存在，有记录但是查询不到具体诉讼信息的情况
}

//参数描述
    "cpws": [    //裁判文书
        {
            "yiju"          : "依据",
            "pname"         : "当事⼈",
            "sortTime"      : "审结时间 时间戳",
            "judgeResult"   : "判决结果",
            "matchRatio"    : "匹配度",
            "body"          : "主体内容",
            "court"         : "法院名称",
            "title"         : "标题",
            "caseNo"        : "案号",
            "caseType"      : "案由",
            "entryId"       : "裁判⽂书ID",
            "courtRank"     : "法院等级： 最⾼院；  ⾼院；  中院；  其他；",
            "caseCause"     : "案由",
            "sortTimeString": "审结时间 时间日期字符串",
            "judge"         : "审判员",
            "partyId"       : "当事⼈ID",
            "trialProcedure": "审理程序"
        }
    ],
    "zxgg": [       //执行公告
        {
            "sortTimeString"    : "审结时间 时间日期字符串",
            "pname"             : "当事⼈",
            "sortTime"          : "审结时间 时间戳",
            "caseState"         : "案件状态： 立案; 审理; 已发布; 已结案; 执行中; 执行完毕; 终结; 终结本次执行程序",
            "idcardNo"          : "身份证号码",
            "matchRatio"        : "匹配度",
            "body"              : "主体内容",
            "court"             : "法院名称",
            "execMoney"         : 执行金额,
            "title"             : "标题",
            "caseNo"            : "案号",
            "entryId"           : "裁判⽂书ID",
        }
    ],
    "ktgg": [           //开庭公告
        {
            "plaintiff"     : "原告",
            "pname"         : "当事⼈",
            "sortTime"      : "审结时间 时间戳",
            "matchRatio"    : "匹配度",
            "body"          : "主体内容",
            "court"         : "法院名称",
            "title"         : "标题",
            "caseNo"        : "案号",
            "entryId"       : "裁判⽂书ID",
            "caseCause"     : "案由",
            "sortTimeString": "审结时间 时间日期字符串",
            "courtroom"     : "法庭 / 审判室",
            "defendant"     : "被告人",
            "organizer"     : "承办单位",
            "judge"         : "审判员"
        }
    ],
    "bgt": [           //曝光台
        {
            "address"           : "地址",
            "yiju"              : "依据",
            "pname"             : "当事⼈",
            "proposer"          : "法院",
            "sortTime"          : "审结时间 时间戳",
            "idcardNo"          : "身份证号码",
            "unnexeMoney"       : "未执行金额",
            "matchRatio"        : "匹配度",
            "body"              : "主体内容",
            "court"             : "法院名称",
            "execMoney"         : "执行金额",
            "partyType"         : "参与方类型",
            "caseNo"            : "案号",
            "entryId"           : "裁判⽂书ID",
            "caseCause"         : "案由",
            "sortTimeString"    : "审结时间 时间日期字符串",
            "bgDate"            : "开始日期"
        }
    ],
    "ajlc": [           //案件流程信息
        {
            "caseCause"         : "案由",
            "sortTimeString"    : "审结时间 时间日期字符串",
            "ajlcStatus"        : "案件状态  如 立案...",
            "pname"             : "当事⼈",
            "sortTime"          : "审结时间 时间戳",
            "matchRatio"        : "匹配度",
            "body"              : "主体内容",
            "court"             : "法院名称",
            "caseNo"            : "案号",
            "caseType"          : "案由",
            "entryId"           : "裁判⽂书ID",
        }
    ]