使用eBay RESTful API
<p><strong>使用eBay RESTful API</strong>
eBay API现在被编写为RESTful。本指南介绍了高级REST调用和响应机制。它还提供了在使用eBay API编写应用程序时所需的其他信息（包括如何生成OAuth令牌以及如何解析错误消息）。</p>
<p>本指南位于REST文档层次结构的顶层，应在使用各个API之前阅读。</p>
<p><strong>什么是REST？</strong>
REST代表REpresentational State Transfer，它可能对你理解它是什么没有多大帮助。实际上，这意味着您或您的程序使用标准Web命令和协议（如HTTP请求和响应）与远程运行的服务进行通信。您向服务发送包含在HTTP请求中的API命令，并使用成功或失败指示符以及任何结果数据进行响应，所有这些都包含在HTTP响应中。</p>
<p>这意味着REST API本身是无状态的。状态在客户端或服务端维护，但不在API内。因此全名; 代表性国家转移。REST API将状态从客户端传输到服务器，反之亦然。</p>
<p><strong>使用REST的好处</strong>
REST的一个主要优点是HTTP被广泛使用。此外，发送和接收HTTP请求和响应不会占用太多带宽。</p>
<p>此外，REST使用的语法和协议（JSON和URI寻址协议）是众所周知的，并且已经融入您已经使用Web的方式。底层系统已经构建和安装，任何人都可以使用它。这最大限度地减少了用户和开发人员为使应用程序启动和运行所必须完成的工作量。理论上，所有RESTful API都具有相同，易于学习的界面格式。</p>
<p>REST架构强调客户端和服务之间的交互通过使用有限数量的操作来增强。具体来说，有四种常见的HTTP 方法可以为您提供完整的“CRUD”功能：创建，检索，更新和删除。每个主要的HTTP方法（GET，POST，PUT和DELETE）在REST架构中都有特定的含义，这样REST就避免了歧义。您可以将HTTP方法视为休息操作中的动词。</p>
<p>为了灵活性，我们为资源分配 了自己独特的统一资源标识符（URI）。资源是REST操作中的名词，通常由单个实体或一组类似实体组成。</p>
<p>本指南中的主题包括以下信息：</p>
<ul>
<li>请求组件 - 构成REST请求的原因以及如何将其组合在一起。</li>
<li>OAuth访问令牌 - eBay的REST界面使用OAuth 2.0 访问令牌进行应用程序身份验证和用户授权。本主题介绍如何获取，使用和刷新访问令牌。</li>
<li>响应组件 - 构成REST响应的原因，以及解析和解释它的方式。</li>
<li>处理错误消息 - 本主题描述了eBay关于HTTP响应如何返回错误和警告消息的通用格式。</li>
<li>Open API和Swagger - OpenAPI的概述，以及如何使用其相关的Swagger工具为多种编程语言的eBay API生成客户端库。</li>
<li>在沙盒中进行测试 - 如何在eBay沙箱中测试您的应用程序，这是一个独立的测试环境，不会影响实时列表，用户帐户或银行帐户。</li>
<li>安全性和您的eBay应用程序 - 客户端和服务端需要保护哪些数据，以及如何在服务端保护数据以及如何在客户端保护数据。</li>
<li>支持应用程序开发 - 如果您在开发应用程序时遇到问题，请在何处以及如何获得帮助。</li>
</ul>