SAP Concur将在HTTP报头和SOAP报头中发送用户名和密码。如果用户名和密码生成了身份验证错误,那么SAP Concur会收到HTTP 403响应。
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头将包含一个身份验证元素。
身份验证
的名字 | 类型 | 描述 |
---|---|---|
用户标识 |
字符串 |
要求包含身份验证细节。 |
密码 |
字符串 |
要求包含身份验证细节。 |
示例:
<头xmlns =“http://schemas.xmlsoap.org/soap/envelope/”><身份验证xmlns =“//www.g-goddess.com/webservice/auth”><标识>testLogin123< / userid ><密码>xxxxxxxxxxxx< /密码>> < /认证< /头>
登录名和密码由酒店供应商提供给SAP Concur作为API消费者,而不是每个客户。
每条消息必须包含以下所需的属性和元素。在这些之上,每个消息可以指定额外的属性和元素。详情请参阅特定消息页面。
的名字 | 类型 | 描述 |
---|---|---|
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的客户或消息的替代语言。 |
成功/错误 |
复杂的 |
要求成功或错误。指的是错误处理页以了解更多详情。 |