SAP Concur将在HTTP报头和SOAP报头中发送用户名和密码。如果用户名和密码生成了身份验证错误,那么SAP Concur会收到HTTP 403响应。

HTTP头信息

SAP Concur将在每个请求中发送以下HTTP报头。Authentication报头的内容将在SOAP有效负载中重复。请注意,一些用于处理请求的库可能是区分大小写的。

的名字 类型 描述
授权 字符串 形式为的Base64编码字符串基本的< >用户名:密码
SOAPAction 字符串 消息类型。动作总是用小写字母发送。例子:搜索
内容类型 字符串 所有与HS2 API的通信都是通过a应用程序/ xml内容类型。
接受 字符串 SAP Concur将始终设置接受头来应用程序/ xml
Accept-Charset 字符串 SAP Concur将始终设置Accept-Charset头来utf - 8
concur-correlationid 字符串 这个唯一的代码可以在故障排除期间使用,因为它在日志文件中标识API调用。
concur-traveleruuid 字符串 一旦配置文件创建完成,标识concurrent中的旅行者的UUID将始终被发送。
concur-loginid 字符串 旅客的登录ID。仅在可用时发送。

支持soapaction:

Soapaction 功能
搜索 用于执行搜索
可用性 用于执行可用性
ratedetails 用于执行速率详细信息
细节 用于表演酒店描述
用于执行预约
用于执行Read Itinerary
取消 用于执行取消

故障排除

为了帮助进行故障排除,SAP Concur在请求头中提供了唯一的correlationId。寻找的关键是correlationid.这个唯一的代码可以在故障排除期间使用,因为它在日志文件中标识API调用。您也应该在您自己的API调用日志中记录这些信息,以便您可以将这些信息传递给SAP Concur支持团队。

来自网络捕获的HTTP报头示例:

Accept: application/xml Accept- charset: utf-8 Authorization: ******************* concurrent -correlationid: A75CE5BC-90BA-4BF8-8DEA-69FA2E66E936 concurrent -loginid: abc@concur.com concurrent -traveleruuid:  Content-Type: application/xml;SOAPAction: search Accept-Encoding: gzip . charset="utf-8

Soap消息头

嵌套在信封中的Soap头将包含一个身份验证元素。

身份验证

的名字 类型 描述
用户标识 字符串 要求包含身份验证细节。
密码 字符串 要求包含身份验证细节。

示例:

<头xmlns =“http://schemas.xmlsoap.org/soap/envelope/”><身份验证xmlns =“//www.g-goddess.com/webservice/auth”><标识>testLogin123< / userid ><密码>xxxxxxxxxxxx< /密码>> < /认证< /头>

登录名和密码由酒店供应商提供给SAP Concur作为API消费者,而不是每个客户。

OTA消息标头

每条消息必须包含以下所需的属性和元素。在这些之上,每个消息可以指定额外的属性和元素。详情请参阅特定消息页面。

请求消息头

的名字 类型 描述
EchoToken stringLength1to128 要求附加消息标识的参考,由发出请求的主机系统分配。
版本 要求用十进制值表示的OpenTravel消息版本。
PrimaryLangID 字符串 要求编码为ISO 639-1的消息的主要语言首选项。
AltLangID 字符串 要求编码为ISO 639-1的客户或消息的替代语言。
POS 复杂的 要求销售点(POS)标识发出请求的一方或连接通道。

POS

的名字 类型 描述
来源 复杂的 要求这包含了请求者的详细信息。马克斯发生:10

SAP Concur将始终发送ISO货币。

的名字 类型 描述
ISOCurrency alphaLength3 要求货币代码。
RequestorID 复杂的 示例:ATA/IATA/ID号、电子预订服务提供商(ERSP)、英国旅行社协会(ABTA)

RequestorID

的名字 类型 描述
类型 stringLength1to32 要求支持的值:1
ID stringLength1to32 要求请求者ID。

响应消息头

供应商需要在任何消息的根中使用下列属性和元素进行响应。每个消息都可以指定额外的属性和元素。详情请参阅特定消息页面。

的名字 类型 描述
EchoToken stringLength1to128 要求附加消息标识的参考,由发出请求的主机系统分配。当请求消息包含回显令牌时,相应的响应消息必须包含具有相同值的回显令牌。
时间戳 datetime 要求响应操作的时间戳。
版本 要求用十进制值表示的OpenTravel消息版本。
PrimaryLangID 字符串 要求编码为ISO 639-1的消息的主要语言首选项。
AltLangID 字符串 要求编码为ISO 639-1的客户或消息的替代语言。
成功/错误 复杂的 要求成功或错误。指的是错误处理页以了解更多详情。