API Key 权限
正确决定你的应用程序需要的访问权限。
当你申请一个新的印象笔记 API key 时,你可以选择你的应用需要的访问权限:
- 基本访问权限 - 适用于只在印象笔记中创建内容,而不读取或更新已有内容的应用
- 完整访问权限 - 适用于需要创建,读取和更新笔记,笔记本和标签的应用
下表总结了每种权限类型授予你 API key 的可用操作:
访问权限 | 基本访问权限 | 完整访问权限 |
---|---|---|
创建新笔记 | ✓ | ✓ |
创建新笔记本 | ✓ | ✓ |
创建新标签 | ✓ | ✓ |
读取已有的笔记本 | ✓ | ✓ |
读取已有的标签 | ✓ | ✓ |
读取已有的笔记 | ✓ | |
更新已有的笔记 | ✓ | |
更新已有的笔记本 | ✓ | |
更新已有的标签 | ✓ | |
将笔记作为邮件发送 |
如果你要申请具有完整访问权限的API Key,你必须使用应用笔记本。也就是说,你只能对用户授权指定的笔记本拥有完整访问权限。
某些 API 函数只能由印象笔记的官方应用或服务使用。API 参考中对这些函数进行了描述,第三方应用调用它们时会抛出错误代码为PERMISSION_DENIED
的EDAMUserException
异常。如果你觉得你的应用需要获取对这些保留函数中的一个或多个的访问权限,那么请联系印象笔记开发者支持。