常见问题
对常见问题的快速答复
- 如何报告一个 bug?
- 如何创建一个 API key?
- 如何将 API 从沙箱服务器切换到生产服务器?
- 我如何联系开发者支持?
- 我如何注册 Webhook?
- 我能够创建笔记, 但是为什么当我调用
findNotes
或者getNote
的得到提示“PERMISSION_DENIED”? - 我想对高级账号进行一些测试,我是否可以升级我在沙箱服务器上的账号?
- 为什么我无法删除笔记、笔记本和标签?
- 为什么我不能在 ENML 中使用 class 或者 id 属性?
- 你们是否提供让第三方贴牌的服务?
- 是否有用来创建印象笔记账号的公开 API ?
- 我是否能为你们的应用创建一个插件?
- Thrift? 为什么使用 Thrift?
如何创建一个 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 。初始用户体验是我们成功的关键,因此我们必须小心的控制这个过程。我们正在致力于为一些流行的开发环境(如 iOS 和 Android )提供一个注册框架,从而让你能够将印象笔记账号创建的用户体验嵌入到你的应用中。
Thrift? 为什么使用 Thrift?
我们的 web service API 有一个独特的地方就是它建立在 Apache Thrift 框架上。作为一个使用我们 API 的开发者,通常你不用考虑 Thrift, 但是如果你非常想知道为什么我们会选择它,可以参考 Dave 的博客So API Together: Evernote and Thrift。