开始

Issuu提供了一个简单的基于rest的界面，使其能够快速、容易地开始使用。

步骤1:申请API密钥

你需要做的第一件事是申请一个API密匙．我们唯一需要的是，你有一个活跃的Issuu帐户，你给我们一点关于你想建立的应用程序的信息。我们非常好奇，想看看你能想出什么很酷的东西!

请记住，API密钥应与任何其他密码一样对待。使用它，您可以执行从ISSU帐户中删除信息和文档等操作。不要向任何人透露或分享你的API密钥!

第二步:选择API方法

在发出请求之前，必须选择一个API方法。根据您想调用的方法，您需要选择正确的端点。

作为一个规则，所有请求都必须向以下端点发出:

http:/ / api.issuu.com/1_0

当使用HTTP GET请求时，参数应该作为URL的一部分发送，或者在HTTP正文中发送HTTP POST请求。

但每一条规则都需要例外！上载文档时，必须使用特殊端点：

http:/ / upload.issuu.com/1_0

当上传文件时，你必须使用编码多部分/表单数据的HTTP POST。

第三步:提出要求

要对Issuu API执行操作，有三个参数必须始终包含在请求中:

• 所需要的参数apiKey用于认证。该请求将代表关联的用户帐户执行。
• 所要求的参数签名用于身份验证。签名的请求介绍如何计算签名值
• 所需参数action用于指定调用方法。

您可以自由选择使用HTTP GET或HTTP POST发送参数。

http://api.issuu。com/1_0吗?apiKey =< apiKey >签名=<签名>&行动=<法>

注意:所有发送到Issuu API的数据必须是UTF-8编码的。API返回的所有数据将使用UTF-8编码。以不同的编码提交数据将导致请求失败，错误代码为201“无效的字段格式”。看到步骤5:处理错误对于常见的错误码。

请求头

当使用POST时，你需要设置所有API调用的Content-Type头为"x-www-form-urlencoded"，除非上传文件。

以POST参数发送数据:

帖子/ 1 _0HTTP / 1.1主办: api.issuu.com内容类型: x-www-form-urlencoded

帖子/ 1 _0HTTP / 1.1主办: upload.issuu.com内容类型:多部分/格式;边界= XXXXXXXXXX

<负责统计＝“ok”><！-有效载荷到这里->负责>

｛“负责”:{“_content”: {/* payload到这里*/}，“统计”：“ok”} ｝

<负责统计＝“失败”><错误密码＝“代码”消息＝“[消息]”场＝“(场)”/>负责>

｛“负责”:{“_content”:{“错误”:{“代码”：“代码”，“消息”：“[消息]”，“字段”：“(场)”} },“统计”：“失败”} ｝