连接请求资源用于将Triplink合作伙伴应用程序与Concur进行集成。它可用于在用户的同意账户和选择旅行忠诚度程序之间创建,更新和管理连接。使用连接请求,Triplink Partner应用程序可以检索新的连接请求,以匹配希望在供应商系统中使用用户的帐户连接到供应商的用户。检索请求后,如果连接成功或失败,供应商将提供状态。检索新连接时,可以按状态,页面偏移量过滤结果,并限制要返回的记录数。
在版本3.2中,连接请求还可以将用户与忠诚度程序相关联,同意验证的电子邮件地址,或两个因素。同意验证的电子邮件是电子邮件地址,用户通过在其电子邮件中收到此内容后,用户通过在Concor UI中输入验证码来确认电子邮件所属的电子邮件。经过验证的电子邮件在Concur系统中的所有用户帐户中具有唯一性。
使用忠诚度号和/或已验证的电子邮件来识别用户基于Concur和Triplink供应商之间的业务协议,并将在Triplink Integration启动过程中讨论。如果供应商在其过程中不使用这些因素将用户与其中的用户匹配给同意用户,则在连接请求中不会在连接请求中返回电子邮件或忠诚度号。
我们对供应商的建议是匹配用户只能使用姓氏和忠诚度号码的用户。或者在没有忠诚度号码的供应商的情况下,仅使用已验证的电子邮件和用户的姓氏。当由于供应商系统内的昵称等问题而使用时,已证明第一个名称和中间名称字段生成高度失败。
检索与Triplink供应商ID匹配的所有连接请求
get /api/v3.2/common/connectionRequests/ get /api/v3.0/connector/connectionrequests/(已弃用)get /api/v3.1/common/connectionrequests/(已弃用)
参数
名称 |
类型 |
格式 |
描述 |
抵消 |
询问 |
细绳 |
已经到达了限制字段中指定的限制后,下一组结果的起点。默认值是页面的开头。 |
限制 |
询问 |
INT32. |
要返回的记录数量。默认值为5,最大值为10。 |
地位 |
询问 |
细绳 |
表示连接请求状态的状态代码。可能的值是挂起的,处理,连接,失败和重试。 |
通过ID检索连接请求
get /api/v3.2/common/connectionRequests/(} get / api/v3.0/common/connectionRequests/(已弃用)get /api/v3.1/common/connectionRequests/(已弃用))
参数
名称 |
类型 |
格式 |
描述 |
ID |
小路 |
细绳 |
必需的连接请求ID。 |
代表特定用户创建连接请求
post /api/v3.2/connecmon/connectionRequests/ post /api/v3.0/common/connectionrequests/(已不推荐使用)post / api/v3.1/common/connectionRequests/(已弃用)
参数
名称 |
类型 |
格式 |
描述 |
用户 |
询问 |
细绳 |
必需的用于创建连接请求的用户的登录ID。用户必须具有Web服务管理角色以使用此参数。 |
更新连接请求
put /api/v3.2/common/connectionRequests/(} put /api/v3.0/conmon/connectionrequests/(已弃用)put / api/v3.1/common/connectionRequests/(已弃用))
参数
名称 |
类型 |
格式 |
描述 |
ID |
小路 |
细绳 |
必需的连接请求ID。 |
内容 |
身体 |
- |
必需的连接请求对象更新。 |
架构3.2
连接请求
名称 |
类型 |
格式 |
描述 |
项目 |
大批 |
连接请求 |
结果收集。 |
下一页 |
细绳 |
|
结果的下一页的URI,如果有的话。 |
连接请求
名称 |
类型 |
格式 |
描述 |
名 |
细绳 |
- |
用户的名字。 |
ID |
细绳 |
- |
资源的唯一标识符。 |
上一次更改 |
细绳 |
- |
最后修改连接请求的日期和时间。格式:UTC. |
姓 |
细绳 |
- |
用户的姓氏。 |
忠诚度Number. |
细绳 |
- |
用户的旅行忠诚度号码。 |
中间名字 |
细绳 |
- |
用户的中间名。 |
cequestToken. |
细绳 |
- |
请求令牌。 |
地位 |
细绳 |
- |
表示连接请求状态的状态代码。 |
Uri. |
细绳 |
- |
资源的URI。 |
用户身份 |
细绳 |
- |
用户的唯一标识符。 |
电子邮件地址 |
UserEmailAddresses. |
用户电子邮件地址 |
与用户关联的电子邮件地址。 |
用户电子邮件地址
名称 |
类型 |
格式 |
描述 |
电子邮件1 |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件2 |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件3. |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件4. |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件5. |
细绳 |
- |
用户已验证的电子邮件地址。 |
架构3.0(已弃用)
连接请求
名称 |
类型 |
格式 |
描述 |
项目 |
大批 |
连接请求 |
结果收集。 |
下一页 |
细绳 |
|
结果的下一页的URI,如果有的话。 |
连接请求
名称 |
类型 |
格式 |
描述 |
名 |
细绳 |
- |
用户的名字。 |
ID |
细绳 |
- |
资源的唯一标识符。 |
上一次更改 |
细绳 |
- |
最后修改连接请求的日期和时间。格式:UTC. |
姓 |
细绳 |
- |
用户的姓氏。 |
忠诚度Number. |
细绳 |
- |
用户的旅行忠诚度号码。 |
中间名字 |
细绳 |
- |
用户的中间名。 |
cequestToken. |
细绳 |
- |
请求令牌。 |
地位 |
细绳 |
- |
表示连接请求状态的状态代码。 |
Uri. |
细绳 |
- |
资源的URI。 |
架构3.1(已弃用)
连接请求
名称 |
类型 |
格式 |
描述 |
项目 |
大批 |
连接请求 |
结果收集。 |
下一页 |
细绳 |
|
结果的下一页的URI,如果有的话。 |
连接请求
名称 |
类型 |
格式 |
描述 |
名 |
细绳 |
- |
用户的名字。 |
ID |
细绳 |
- |
资源的唯一标识符。 |
上一次更改 |
细绳 |
- |
最后修改连接请求的日期和时间。格式:UTC. |
姓 |
细绳 |
- |
用户的姓氏。 |
忠诚度Number. |
细绳 |
- |
用户的旅行忠诚度号码。 |
中间名字 |
细绳 |
- |
用户的中间名。 |
cequestToken. |
细绳 |
- |
请求令牌。 |
地位 |
细绳 |
- |
表示连接请求状态的状态代码。 |
Uri. |
细绳 |
- |
资源的URI。 |
电子邮件地址 |
UserEmailAddresses. |
用户电子邮件地址 |
与用户关联的电子邮件地址。 |
用户电子邮件地址
名称 |
类型 |
格式 |
描述 |
电子邮件1 |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件2 |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件3. |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件4. |
细绳 |
- |
用户已验证的电子邮件地址。 |
电子邮件5. |
细绳 |
- |
用户已验证的电子邮件地址。 |