简介
本博客旨在提供SAP Hybris Marketing OData v2.0 API集的附加信息和技巧，该API集可用于Hybris Marketing 1709以后的产品。请参阅参考文件，因为它们提供了启用这些服务的详细技术信息和服务的先决条件。
我将重点介绍构成Hybris营销概念领先地位的联系人和交互数据。我使用的是POST$batch services，这个博客记录了使用SAP Hybris Marketing OData$batch services的经验。可供参考的遗留服务是CUAN\u IMPORT\u SRV
odatav2.0交互API用于记录给定联系人的"发生了什么事"。一些例子可能包括来自Twitter/Facebook的社交帖子、点击电子商务网站、点击电子邮件等等。有关API的更多详细信息，新零售企业应用中心，请参见：https://help.sap.com/viewer/0f9408e4921e4ba3bb4a7a1f75f837a7/1805.500/en-US/6322d15482854566a72f6c9f1ab6cd1e.html
目录
SAP OData v2.0概述工具书类预先请求站点$Batch OData背景$SAP上的批处理OData创建联系人（API\U MKT\U Contact\U SRV）创建一个新的交互关联以创建联系人（API\u MKT\u Interaction\u SRV）确定有效载荷后的挑战可变/意外的HTTP响应代码行为
SAP Odata V2.0 API广泛经验
从2016年开始，SAP开始为其云服务发布新的Odata API集。我很高兴与Hybris Cloud for Customer、Hybris Marketing和S/4HANA Cloud API一起工作
这些API都是抽象的API包装器，它们触及了底层sapapi服务。请参阅下面的体系结构图，其中给出了服务分层的上下文和添加自定义服务的可扩展性。
RESTy接口附加功能，如$batch支持（以前不可用于yMarketing文档导入）修补数据（以前不可用）的能力，以及更好地记录服务中的错误（以前描述较少）。新加入SAP的SAP集成商可能更容易处理抽象、有限的API集。更清楚地了解了针对哪些数据对象的工作，商业大数据分析，并允许新的SAP集成商以更少的功能性知识快速获取服务。
文档的可用性文件的完整性填补SAP功能空白（与旧的API服务、JCO等相比，文档记录较少）HTTP响应代码是不一致的，物联网管理平台，因此不是非常有用或有用的信息复杂的语法，严格的字段值，有限的API发现。
我希望我的经验可以节省一些时间，并为您的研究提供额外的信息。
参考资料：
以下是我在研究过程中遇到的文档，可能对您有所帮助：
如何使用SAP Hybris Marketing Cloud 1711的新联系人OData APIhttps://blogs.sap.com/2018/01/18/how-to-use-the-new-contact-odata-api-for-sap-hybris-marketing-cloud-1711SAP Hybris营销云文档https://help.sap.com/viewer/p/sap\u HYBRIS\u MARKETING\u CLOUDSAP Hybris Marketing Cloud文档–公共OData API（API\u MKT\u交互）https://help.sap.com/viewer/0f9408e4921e4ba3bb4a7a1f75f837a7/1805.500/en-US/6322d15482854566a72f6c9f1ab6cd1e.htmlSAP API业务中心—SAP Hybris营销云https://api.sap.com/shell/discover/contentpackage/SAPS4HANAMarketingCloud新-api-odata-v4.0-syntax-in-hybris-marketing-from-1709https://blogs.sap.com/2017/10/16/new-api-odata-v4.0-syntax-in-hybris-marketing-from-1709/
预需求网站
交互联系人（OData API"API\U MKT\U交互联系人"）交互（OData API"API\u MKT\u INTERACTION\u SRV"）设置详细信息：https://blogs.sap.com/2018/01/18/how-to-use-the-new-contact-odata-api-for-sap-hybris-marketing-cloud-1711/
$Batch Ddata Background
OData$Batch允许用户传递包含多个底层API调用的单个POST负载。这对于链式操作非常有用，链式操作必须先创建相关记录，或者导入非常大的记录集。
$batch使用内容类型multipart/mixed。这允许发送多个调用，但对不熟悉OdataV4的用户提出了额外的挑战
$Batch OData on SAP odatav2.0api的
我很难理解错误消息。到目前为止，新云，我已经对这些API的
有效负载建立了以下理解：在$batch processing之前，对SAP Hybris中的无效字段值进行验证，如果发现问题，则返回错误。并非所有字段都经过验证，因此即使调用失败，我也经常收到200个有些拾取列表返回错误，有些则不返回。注意API是SAP OData版本2.0，但是它遵循OData版本4.0标准.https://www.odata.org/documentation/
创建联系人（API\U MKT\U Contact\U SRV）
首先，我们将成功发布联系人。我将用邮递员来测试服务。SAP使用头属性x-csrf-token来防止跨站点伪造攻击。您需要使用GET获取此信息，并在后续的POST请求中传递它。
使用基本身份验证创建GET请求（任何打开的Odata服务都有效）
将"x-csrf-token"参数设置为"Fetch"。这将检索POST请求的令牌
发送请求，并从响应头
POST Contact:https://{ymarketur}/sap/opu/odata/sap/API\MKT\u Contact\u SRV/$batch复制"x-csrf-token"值输入URL并将方法设置为POST确保您的授权标头存在将步骤1中检索到的"x-csrf-token"值粘贴到POST请求头中将"Content Type"设置为multipart/mixed设置边界（这告诉$batch OData服务从何处开始/停止查找请求）**对于成功调用非常重要**空白对于维护
API调用配置很重要，请注意URL、3个标题和内容类型：在正文部分，选择"原始"并键入文本
