创建邀请任务(无需账号)
接口描述:创建邀请任务,被邀请人收到通知后需要注册并完成实名认证方可开通电子签名服务。
接口地址:/v1/invitationWithData
请求方式: POST
请求参数:
参数名 | 参数类型 | 必选 | 类型 | 说明 |
---|---|---|---|---|
inviteType | body | 是 | string | 邀请个人实名为PERSON,邀请企业为ORGAN |
mobile | body | 否 | string | 被邀请人手机号 |
body | 否 | string | 被邀请人邮箱,若手机号和邮箱都传入,则仅手机号有效 | |
name | body | 否 | string | 被邀请人姓名 |
inviteeCertType | body | 否 | string | 被邀请人证件类型,详见个人证件类型说明 ,默认CRED_PSN_CH_IDCARD |
idNumber | body | 否 | string | 被邀请人证件号 |
organName | body | 否 | string | 企业名称 |
organCertType | body | 否 | string | 企业证件类型,详见机构证件类型说明 ,默认CRED_ORG_USCC |
organCertNo | body | 否 | string | 企业证件号 |
legalName | body | 否 | string | 企业法定代表人姓名 |
legalCertType | body | 否 | string | 企业法定代表人证件类型,详见个人证件类型说明 ,默认CRED_PSN_CH_IDCARD |
legalNo | body | 否 | string | 企业法定代表人证件号 |
redirectURL | POST | 否 | string | 结束后重定向地址(需加前缀https:// 或 http:// ),默认停留在当前页面 |
callbackURL | POST | 否 | string | 回调接口地址,默认为空,不回调 |
bizId | POST | 否 | string | 业务方id,重定向和回调时都回传这个id |
notifyType | POST | 否 | string | 默认为空,传入“sms”表示短信,“email”表示邮件,若两者都传入,则只发送短信 |
请求示例
POST /v1/invitations
{
"bizId": "123456",
"callbackURL": "https://www.baidu.com",
"inviteeOid": "123456789",
"notifyType": "sms",
"redirectURL": "http://127.0.0.1"
}
响应参数
参数名称 | 说明 | 类型 |
---|---|---|
invitationId | 邀请任务id | string |
invitationURL | 邀请链接 | string |
响应示例
{
"code": 0,
"message": "成功",
"data": {
"invitationId": "d07b82c59a534681a6dd34a692ac53f1",
"invitationURL": "https://ttapi.tsign.cn/account-webserver/redirect/invite/init?contextId=d07b82c59a534681a6dd34a692ac53f1&inviteId=6490589a430b498fb3aed2281432ad1f"
}
}