通知开通接口

  • 接口(建议后缀): /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"
  }
}

results matching ""

    No results matching ""