通知开通接口
- 接口(建议后缀): /corp/create/signal
- Method-Type:POST
- 数据格式:Json
- 调用方:每刻
- 接口说明:企业管理员在每刻系统中,通过该接口通知第三方开通企业账号。
请求参数
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
entCode | String | Y | 企业在每刻中的唯一标识 |
entName | String | Y | 企业营业执照上的名称 |
contactName | String | Y | 企业联系人 |
contactTel | String | Y | 企业联系电话 |
响应结构
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
success | bool | Y | 接收请求是否成功 |
errorMessage | String | N | 失败信息(当 success 返回为 false 时,该字段必填) |
data | Corp | [1] | 企业信息 |
[info] 说明:
[1] 是否返回 data 取决于第三方何时创建企业,如果在通知开通接口被调用时创建,则需要返回,如果在合约签订时创建,则在开通成功通知接口返回,请参考企业开通流程图。
Corp
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
entCode | String | Y | 企业在每刻中的唯一标识 |
externalCorpCode | String | [2] | 企业在 TMC 中的账号 [3] |
externalCorpAuthCode | String | [4] | 企业认证 code |
externalCorpSecret | String | [5] | 企业在 TMC 中的认证密码 |
[info] 说明:
[2] 第三方如果是在合同签订完成后才进行企业账号的开通,这里的 externalCorpCode 可以置空,只需在开通成功通知时带回每刻。
[3] 接下来所有涉及区分企业的接口,都使用第三方提供的 externalCorpCode 标识。
[4] 有些第三方 externalCorpCode 并不作为认证的 code(有单独的 code),针对这种第三方,需要通过 externalCorpAuthCode 将企业认证 code 带过来。
[5] 如果第三方通过企业单独认证,需要传 externalCorpSecret 这个值。
示例
[warning] 重要:
示例维护并非和文档字段维护一样频繁,如果遇到示例和文档不一致,请以文档为准
请求头
{
"tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}
请求示例
{
"entCode": "EC2384W2SDB32MT5",
"entName": "正业科技有限公司(测试)",
"contactName": "张三",
"contactTel": "18837829461"
}
响应示例
{
"success": true,
"errorMessage": null,
"data": {
"entCode": "EC2384W2SDB32MT5",
"externalCorpCode": "xxxxxxxxxxxx",
"externalCorpSecret": "yyyyyyy"
}
}