常见问题

对常见问题的快速答复


如何报告一个 bug?

你可以可以在这里报告这个bug。在发邮件之前,请确定你在开发者支持页面搜索过你的问题的解答。

如何创建一个 API key?

你可以通过完成并提交申请表单(点击页面上方的“获取 API Key&@8221;)来创建一个新的 API key。 你的 API key 会立刻在沙箱环境(我们的开发服务器)生效。

如何将 API 从沙箱服务器切换到生产服务器?

这个过程称之为 key 激活. 要在印象笔记生产服务器上激活 API key, 请使用该表单提交一个 key 激活请求。一旦我们认为你的集成已经满足了产品级别应用的标准,你的 key 将会在两个工作日内被激活。当你的 key 被激活的时候你会被通知(或者你的应用存在需要解决的问题)。

我如何联系开发者支持?

如果你通过查阅 FAQ,搜索开发者网站和用户论坛之后,仍然需要帮助,你可以发送邮件到 dev-api@yinxiang.com 向我们的开发者支持部门求助。注意:如果你不是开发者并且需要支持,你可以从这里获得帮助。

我如何注册 Webhook?

要注册 Webhook,请填写开发者支持表单。包含你的 Webhook 将要访问的 URL 和将要应用的 笔记过滤器。一旦我们收到你的请求,你的 Webhook 通常会在两个工作日内被激活,并且将会收到一封确认邮件。

我能够创建笔记, 但是为什么当我调用 findNotes 或者 getNote 的得到提示“PERMISSION_DENIED”?

印象笔记的 API key 可以被赋予两组访问权限:基本和完全。拥有基本权限的 Key 可以创建笔记,同时可以读取笔记本、标签和保存的查询。拥有完全访问权限的 key 除此之外,还可以读取并修改用户帐户里已经存在的笔记。

如果你试图用一个只有普通访问权限的 key 来调用将会读写用户已经存在的笔记的函数(例如 findNotes 或者 getNote),将会报 PERMISSION_DENIED 错。如果你需要完全的访问权限,请联系开发者支持。我们在经过认真评估之后将会修改你的 API key 权限。

我想对高级账号进行一些测试,我是否可以升级我在沙箱服务器上的账号?

当然可以。联系开发者支持并且包括你在沙箱上用户名,我们会为你升级账号。

为什么我无法删除笔记、笔记本和标签?

尽管在印象笔记 API 参考中有定义,但是调用任何以expunge开始的函数将导致PERMISSION_DENIED错误。这些函数将会永久性删除用户印象笔记里面的内容,并且不向第三方应用开放。但是你可以调用deleteNote来将一条笔记移到废纸篓。

为什么我不能在 ENML 中使用 class 或者 id 属性?

笔记通常会包含完整的网页,有时单个笔记中也会包含多个页面。在这种情况下,可能会存在class或id属性冲突,例如同一笔记中多个元素拥有相同的ID或者class。因此为了避免在处理和应用样式表时产生副作用,ENML中不支持使用class和id属性。

你们是否提供让第三方贴牌的服务?

不会。印象笔记只专注于为现有客户提供服务。使用印象笔记 API 创建应用,可以访问所有在印象笔记注册过并授权该应用访问的用户账号。

是否有用来创建印象笔记账号的公开 API ?

没有。我们不会开放创建账号的 API 。初始用户体验是我们成功的关键,因此我们必须小心的控制这个过程。我们正在致力于为一些流行的开发环境(如 iOS 和 Android )提供一个注册框架,从而让你能够将印象笔记账号创建的用户体验嵌入到你的应用中。

我是否能为你们的应用创建一个插件?

不能。目前我们还没有任何插件机制。当你使用我们的 API 的时候,你是通过你自己的外部应用来访问印象笔记的 web 服务或者我们的某个客户端。

Thrift? 为什么使用 Thrift?

我们的 web service API 有一个独特的地方就是它建立在 Apache Thrift 框架上。作为一个使用我们 API 的开发者,通常你不用考虑 Thrift, 但是如果你非常想知道为什么我们会选择它,可以参考 Dave 的博客So API Together: Evernote and Thrift