此API已被弃用。

合作伙伴和客户使用已弃用API应联系SAP Confur并讨论转移到最新版本。

了解更多内容API生命周期和弃用政策。

当SAP Confur用户更改其SAP Confur帐户或数据的指定功能时，请订阅通知。目前支持以下事件的通知：Itinerary更改（创建或更新），旅行简介基本信息更改，或旅行简介的付款方式。此功能仅限于在SAP Concur注册的旅行供应商或TMC（旅行管理公司）。

笔记：此资源只能由已选择的合作伙伴应用程序访问用户API范围。

资源URI.

认购：

https://www.concursolutions.com/api/user/v1.0/subscribe.

退订：

https://www.concursolutions.com/api/user/v1.0/unsubscribe.

标题

内容类型标题

应用程序/ XML

接受标题

应用程序/ XML

运营

订阅通知行程更改

当用户添加，修改或取消行程时，从通知订阅或取消订阅旅行供应商。此功能仅适用于在SAP Concur的App Center选项卡上具有应用程序的旅行供应商。供应商还必须已收到用户授权以访问其旅行信息。

要求

认购：

shell：//www.concursolutions.com/api/travelprofile/v1.0/subscribe？type =行程

退订：

https://www.concursolutions.com/api/travelprofile/v1.0/unsubscribe?type=立管

请求参数

姓名 描述
type =行程 订阅类型。必需的。

标题

授权标题

必需的。授权标题为所需的SAP同意用户的OAuth令牌。这一令牌被授予的一部分OAuth 2.0 Web流授权过程。

示例：订阅Itinerary更改

post https://www.concursolutions.com/api/travelprofile/v1.0/subscribe?type.=行程http / 1.1授权：OAuth{访问令牌}

行程变更响应的发布通知订阅

通知格式

该通知将被发送到回拨URL，供应商在申请审查期间在SAP Confir中注册。供应商只能为所有通知类型提供一个回拨URL。通知将包括类型和oauth_token_key.查询参数，指定更新用户的OAuth信息：

https://postbackurl.com?type=itinerary&ooauth_token_key=（oauth_token}

响应体模式

该请求将包括一个通知父元素，具有以下子元素：

元素 描述
ObjectType. 行程
objecturi. 对象的URI。开发人员可以使用适当的Get Endpoint与objectURI获取旅行的完整详细信息。对于行程，Objecturi值与TripID值相同。
EventDateTime. 事件发生后。格式：YYYY-MM-DDTHH：MM：SS
事件类型 改变的类型。格式：创建，更新，取消
语境 这不是使用但尚未使用，但将来将用于指定旅行的变化。开发人员可以与EventType一起使用它来决定如何处理通知。
三鼎 旅行的唯一标识符。格式：字符串

示例：以XML格式发出通知

发布https://www.postbackurl.com?type.=Itinerary＆Oauth_Token_Key.= {oauthtoken.}http / 1.1授权：OAuth{访问令牌}内容类型：应用程序/ XML
<？XML Version =“1.0”编码=“UTF-8”？><通知>行程https://www.concursolutions.com/api/travel/trop/v1.1/naizqj0y2dbwjciqob2shtsozwbshdkdp.2013-02-13T08：12：35创建naizqj0y2dbwciqob2shtsozwbshdkdp.

行程变更成功响应的XML示例

200 OK.

订阅付款方式通知

描述

当用户的付款信息更改时，订阅或取消订阅旅行供应商免于通知。此功能仅适用于在SAP Concur的App Center选项卡上具有应用程序的旅行供应商。供应商还必须已收到用户授权以访问其形式的付款信息。

笔记：SAP Concur将在更新用户付款方式的任何区域时发送通知。这可能包括通过旅行简档Web服务不可用的字段。

付款方式后通知订阅变更请求

请求参数

姓名 描述
type = fop. 订阅类型。必需的。

例子

认购：

https://www.concursolutions.com/api/travelprofile/v1.0/subscribe?type=fop.

退订：

https://www.concursolutions.com/api/travelprofile/v1.0/unsubscribe?type=fop.

标题

授权标题

必需的。授权标题为所需的SAP同意用户的OAuth令牌。这一令牌被授予的一部分OAuth 2.0 Web流授权过程。

XML示例请求

post https://www.concursolutions.com/api/travelprofile/v1.0/subscribe?type.=FOP HTTP / 1.1授权：OAuth{访问令牌}

支付后通知订阅的付款方式变更响应

通知格式

该通知将被发送到回拨URL，供应商在申请审查期间在SAP Confir中注册。供应商只能为所有通知类型提供一个回拨URL。通知将包括类型和oauth_token_key.查询参数，指定更新用户的OAuth信息：

https://postbackurl.com?type=fop&oauth_token_key=（oauth_token}

XML成功响应的示例

200 OK.

订阅旅行资料更改的通知

当用户的旅行简档信息发生变化时，订阅或取消订阅旅行供应商免于通知。此功能仅适用于在SAP Concur的App Center选项卡上具有应用程序的旅行供应商。供应商还必须已收到用户授权访问其旅行配置文件信息。

笔记：SAP Concur将在更新用户旅行配置文件的任何区域时发送通知。这可能包括通过旅行简档Web服务不可用的字段。

要求

请求参数

姓名 描述
类型=配置文件 订阅类型。必需的。

例子

认购：

https://www.concursolutions.com/api/travelprofile/v1.0/subscribe?type=profile.

退订：

https://www.concursolutions.com/api/travelprofile/v1.0/unsubscribe?type=profile.

标题

授权标题

必需的。授权标题为所需的SAP同意用户的OAuth令牌。这一令牌被授予的一部分OAuth 2.0 Web流授权过程。

要求

post https://www.concursolutions.com/api/travelprofile/v1.0/subscribe?type.=简介HTTP / 1.1授权：OAuth{访问令牌}

回复

通知格式

该通知将被发送到回拨URL，供应商在申请审查期间在SAP Confir中注册。供应商只能为所有通知类型提供一个回拨URL。通知将包括类型和oauth_token_key.查询参数，指定更新用户的OAuth信息：

https://postbackurl.com?type=profile&oauth_token_key=（oauth_token}

XML成功响应的示例

200 OK.