企业接口文档

企业接口文档,易背调提供给企业使用的API


创建订单(单人)

接口描述

> 创建订单([需验证](https://www.showdoc.cc/ybd?page_id=1865243955181250 "需验证"))

请求URL

> [通讯地址 + 企业api基础链接](https://www.showdoc.cc/ybd?page_id=1865243955181250 "通讯地址 + 企业api基础链接") + /order/single

请求方式

> POST

请求参数

参数名 类型 说明
packageId int 套餐ID,不使用时填0
itemIdAndMultis string 调查项描述<br/>格式:调查项1:份数,调查项2:份数<br/>例子:1:1,14:1
candidateName string 候选人姓名
candidateIdCardNo string 候选人身份证号码
candidatePhone string 候选人实名手机号码,授权方式为[短信授权]时必填
authType int 授权方式:<br/>1:线下授权<br/>2:短信授权<br/>4:接口文件授权
price int 订单金额(单位:分)<br/>可以不传,传入则会校验正确性
items list 披露项结果 -> ItemWithDisclosure <br/>授权方式为[短信授权]时可以不传(由候选人自行填写披露内容)
ItemWithDisclosure
参数名 类型 说明
itemId int 调查项ID
sections list 分段 -> ItemWithDisclosureSection <br/>一种调查项可以有 n(n≥1)段
ItemWithDisclosureSection
参数名 类型 说明
sectionIndex int 分段索引,从1开始
results list 披露结果 -> ItemWithDisclosureResult
ItemWithDisclosureResult
参数名 类型 说明
k string 披露项key
v string 披露结果

请求示例

{
    &quot;packageId&quot;: 0,
    &quot;itemIdAndMultis&quot;: &quot;1:1,14:1&quot;,
    &quot;candidateName&quot;: &quot;王大宝&quot;,
    &quot;candidateIdCardNo&quot;: &quot;310109199011220531&quot;,
    &quot;candidatePhone&quot;: &quot;13585590312&quot;,
    &quot;authType&quot;: 2,
    &quot;items&quot;: []
}

响应结果

> [响应结构](https://www.showdoc.cc/ybd?page_id=1873739988592287 "响应结构")

参数名 类型 说明
code string 响应码
key string 企业key(同请求中的参数),参考[准备工作](https://www.showdoc.cc/ybd?page_id=1864080192995858 "准备工作")
seq string 业务流水号(同请求中的参数
ts string 时间戳,服务器处理请求的时间,格式为”yyyyMMddHHmmss”
sign string 响应摘要签名,规则同[请求签名](https://www.showdoc.cc/ybd?page_id=1865243955181250 "请求签名")
msg object 订单号和背调号列表 -> CreateOrderResp
CreateOrderResp
参数名 类型 说明
orderNo string 订单号
recordNos list<string> 背调号列表

响应示例

{
    &quot;code&quot;: &quot;000&quot;,
    &quot;key&quot;: &quot;CF6BF781AB82FEF5BFDF96B054ECEB15&quot;,
    &quot;seq&quot;: &quot;s20190415111700&quot;,
    &quot;ts&quot;: &quot;20190415152645&quot;,
    &quot;sign&quot;: &quot;7ed7892cc52021bccdbdfd5c93cbef6f&quot;,
    &quot;msg&quot;: {
        &quot;orderNo&quot;: &quot;20190415152645093&quot;,
        &quot;recordNos&quot;: [
            &quot;20190415152645093983751&quot;
        ]
    }
}

备注

页面列表

ITEM_HTML